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IMPORTANT NOTICE 

Cosmopoltan Electrodes Corporation dbtrfcutes al software on., an "AS IS" bash without warranty. 
CosmopoBtan Electronics Corporation shal not be lable or responsible to the purchaser with respect to 
labBty, loss, or damage caused or aHeged to be caused olrectfy' or Indirectly by the use of this software, 
which Includes but b not Imtted to. any Interruption of service, loss "of business, or andclpatory profits, or 
consequential damage resulting from use of thb software.. 
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Copyright (c) 1981, 1982 by Cosmopoltan Electronics Corporation. 
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Copyright (c) 1981, 1982 by Cosmopoltan Electronics Corporation. 

Thb MANUAL 

Copyright (c) 1982 by Cosmopolitan Electronics Corporation. 



Throughout this manual there will be references made to trademarked products. The (tm) symbol wDI be 
used once here to serve throughout the manual. 

TRS-80 (tm) b a registered trademark of Radio Shack, inc. 
NEWDOS (tm) fa a registered trademark of Apparat, Inc. 
DBLDOS (tm) b a registered trademark of Percom Data Co. 
LDOS (tm) b a registered trademark of Logical Systems Inc. 
TRSDOS (tm) b a registered trademark of Radio Shack. 
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BACKING UP MULTIDOS 

The first thing you must do with your MULT I DOS diskette, Is make a backup. A blank dbkette without the 

write protect notch covered is required for thb procedure, ( 

LEAVE THE WRITE PROTECT TAB ON THE MLLT1DOS DISKETTE. 

(Some of these directions do not apply to the MODEL HI) 

1. Turn on your expansion interface (MODEL I only). 

2. Turn on your peripherals (disk drives, printer, etc.) 

3. Turn on your CPU/keyboard. 

4. Insert your MULTIDOS diskette into drive 0. 

(Open door, insert, close door) 

5. Press the reset button. 



The display will indicate that this is a MULTIDOS diskette and will prompt you to input today's date. 
MULTIDOS WW date your fles with the date you have just entered. If you don't care about dating your 
files press <ENTER>. 

Type BACKUP, then press the <ENTER> key. 

Answer 'Which drive contains the source diskette?' 
With 

Answer 'Which drive for the destination dsketteT" 

With 1 if you have 2 drives (each having the same number of tracks), otherwise answer with 0. 

The next prompt will be: 

■Press "ENTER" when the source dskette is in drive 0'. 

Press the "ENTER" key. 

At thb point MULTIDOS wil! examine the source diskette for track count and density. The track count will 
be 35-MODEL I, and 40-MODEL III. The density will be the one you ordered for the MODEL I, and double 
for the MODEL III. 

Answer Track count for the destination diskette ( 35 to 96 )? 

With the maximum track capacity of the destination drive (usually 35, 40, or 80). 

If you only have a 35 track drive you cannot make a 40 track backup! 

MULTIDOS wilt format the blank diskette, then proceed to duplicate the contents of your MULTIDOS 
dskette. 

If you are only using one drive, BACKUP will tell you when to insert the blank (destination) diskette, and 
when to re-insert your MULTIDOS (source) diskette. During a one drive BACKUP, you wBI have to 
exchange the dskettes several times. 

When BACKUP has completely duplicated your MULTIDOS dskette, 

Completed 

Press "ENTER" when a MULTIDOS system diskette b In drive O' 

WII be dsplayed. Press the "ENTER" key. 

It b recommended that your original MULTIDOS diskette be stored in a safe place and al future backups 
made from the copy you just produced. 
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REGISTRATION 

Please fSI out and mal the registration card when you receive MULTIDOS. As a registered user, this wll 
enable us. to Inform you, at ouF option, of any revisions or updates of MULTIDOS. In correspondence with 
Gosmopoitan Electronics Corporation please state your name, address, registration number, and computer 
type (Model I or Model III). — - 
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What Is MULTIDOS . *.t. ,'—'■' 

This operating system Is the underiyirig; software required to make, the users programs and the 
hardware work together. MULTIOOS was written with the Intent of being user-oriented software 

without bemg superfluous. ..■.'... 

The word "format", bdow, is used to describe the particular systems' logic in communicating with its 

diskette. ~ 

Since we are not experts on other operating systems/ we can only tel you what MULT1DOS is 
capable of doing. To best describe MULTIDOS»s interface capabaites the diagram shown below 
Indicates what can be read/written to. 
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CONV = Convert. VFU = Versatile FUe UtEity 

NOTE 1: These systems wfll have ther address marks changed. *..■■■ 

NOTE 2: EXTREME CAUTION: MULTIDOS does not know the track count. Be sure sufficient space is 
avalable via NEWDOS/80. MULTIDOS does not report correct free space {except CAT/CMD). 
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MULTIDOS MANUAL NOTATION 

The notation In the list below Is used throughout the MULTIDOS manual. 



Syrnbol 

<ENTER> 
<DREAK> 
<SPACE> 

<oomma> 

<LF> 

f i I espec 

drivespec or d 

U 

a space 
punctuation 
single quote ' 



Meaning 

Press the "ENTER 1 key. 

Press the "BREAK" key. 

Press the "SPACE-BAR". 

Press the *,* key. 

A linefeed character , the down-arrow. 

A valid MULTIDOS file. 

A particular disk drive number (0,1,2, or 3} 

For two-side 0', 1', 2'» or 3* for opposite side, 

Brackets enclose opt lonal par ameters. 

The *[• and "j " are not typed irt. 

At feast one mandatory space. 

Must be entered as shown. 

Encloses MULTIDOS responses which are directed 

to the display. 

The triple periods indicate you may optionally 

repeat the last Item in brackets. 



OCNMANDS 

MULTIDOS is simBar to other DOS'S. Whenever the prompt 
MULTIDOS 

is displayed, you may enter a operator command. In the simple form of as BtUe as one word 
folowed by <ENTER>. 

EXAMPLE: 

FREE<ENTER> 

The above command Instructs MULTIDOS to display the amount of free granules remaining on al 
drives. Al of the MULTIDOS commands terminate with <£NTER>. 

The maximum length of a command Is 63 characters folowed by <ENTER>. 

When specifying a diskette fie the term «flespec" wl! be used in this reference manual. The 
MKespec" will be as foBows: 

FILENAMEtfEXTH-PASSWORDfrD] 

FILENAME is the name of the diskette fie. Vald ffenames consist of at least one and not 
more than eight characters. The first character must be alphabetic (A-Z), and the remaining 
characters can be alphabetic or numeric (A-Z, or 0-9). 
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- - ■>■■> ■ ■■:-.■ ■- ^■.^>V ■ ' ; ;-< '"^ ; * "-' W^ftfe • •.:; ;: '- s ".'V ',*.#■•,.: ■. ■, >u -v, - «■■ v.r- .J * ■ '* v - ,- ^ ! * ■ -'-^ ' i 
Vf '**■:■;? ■r , o ■;■■:>" v,vjX-"'',^::v:: ";-■'>, 'S.,^-';:':^ ^■■v>:^*^:'v;.:^-.;./%>^;: {.^•p.s-r- ; v/-"*^/^^^-^jS\*-v;.Sv..- .■■.-;.;■»■: >-;/9H^--j£ ;*«'■, *£ 
.,*"■-,.'( » .. ■,-' ■■ /;■ • •«„■..■(. ,;s ■■■. - j ^ ;» e -■>-.i^)>..ii$>*ft*~~±*&%>):'i ^V^vsrv^-:*:;** ..-■'■'- >.*<. j 7v < ■ «■, ■■.'*'■ ""j. * ,■ ■■ ■ vy* • ■-'•"* Vi-' *< * ' '■ 'X 

v ^^,..;. on ^-j^/^oV m bre^than v ^^ *^ h ^*%*-T^' *'\\ 

■ ■■■Zii£f?!> '/ema^lng- characters* cai^ $f*$^ft\, i <x' i ***$**& ''■•A^:\,^i e ^^^f >* c Wf- V^PV", ™wA:^!f1;';^„■ 
%''' :, ' , '!> : ■ entered, for -proper iidentiflcation'fof ."'the , fl^Mor*.:^/ tHs^. later. '' ■/'"■£*■"?! ^--.-.^ .>■■ ,;■-,•■■'",'' ; *'■'> --,/*-;<'' ■.', 

W V PASSWORD >, an optional password consisting of the period symbol and one to eight characters. The 
v, first character must be alphabetic arid, the remaining can be a^habetic or numeric ; ;Y 

i ;' :D is; an optional drivespec consisting of a colon foBowed by a number in'. the range of to, 3. For > 

■■vrj-\. ,.•■;.■ ■■; two-side operatiofi\~ C, ]\ 2*, or 3'»K.;, : ■ ■■■■--,. .'""'-", ■ . „ ■"' ' : V ' -^ „-f': '. ■ ■ ■ /■ 

'ff- Pleasef note* 1 that a fiespec does NOT. have any spaces on it. Spaces are treated as separators ,by.. 
\MULTlDOS. ]\f spaces are in i'«especj, onV the' 1 "contents prececlng the space' wi« be feiterpreted^as ^e > 

.■-,_■ ? :i. The PASSWORD. Ms NOT part of a flespec*s uniqueness. The foBowing, are interpreted as the lame flespeci ' ;' 
\' t '^WDNDER.BOY'^-: : : ■<■':• ViOr^ER.WOW^N • •' WONDER. FUU. ; ; ; ; ' " ; -r '. ■/ ;' ; - -^V-..- 

However, the i fol lowing are unique ft iespecsi' ' '''■' ■'".': 

WCNDERrV W3NDER:2 WDNDER:3' " ' " 

The foBowing are flename extensions generaly employed by micro computer users. 

fASC A basic program stored in ASCIt form. 

/ASM An assembly language source file. 

/BAS A basic program stored in compressed format. 

/CIM A file created via "DUMP". 

/CM) A machine language executable f i le. 

/REL A relocatable object file. 

JSYS An operating system's overlay* 

■ ■■JTXJsl...:\: An ASCU text file, (typically sequential files) 

MlLTiDOS wil Insert the default extenaoh /CMD, if you enter a fiespec without an extension. 
'■'■'■■ EXAMPIE: BACKUP<ENTER> 

MULT1DOS wi! add the extension /CMD to BACKUP, then load and execute the file BACKUP/CMD. 

If you do not assign a drivespec, MULTIDOS w«l search al drives starting with for the fBespec entered. 
If you are initiaBzing a filespec without a drivespec, MULTIDOS will search for the first drive without a 
■ , ; : '..* write proteci ts£b, ■;,:. 



"\ : 
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MULTIDOS 

More on COMMANDS 

'■/Jtlpie DOS commands are allowed when they are separated by a comma and with no spaces. 

EXAMPLE: FREE.DIR 1,CLOCK,BASIC<ENTER> 

1. Dismays iSe frss grilles and frse (3e spaces an 

2. DispUys the directory on drive on*. 

3. Displays the real time tSock. 

4. Loads and executes SUPERBASIC. 

MLLXIDOS wBI repeat the last DOS command if <ENTER> h the only response to the "MtATIDOS 

prompt. 

EXAMPLE: DiR :1<ENTER> 

FoBowed by <ENTER^ wS! again display the directory of the diskette in DRIVE 1. 

NOTE: The diskettes may be changed between the <ENTER>S. 

To "erase" the last DOS command press the <BREAK> key. 



SPECIAL UNIVERSAL COMMANDS 
I - MIGHTY MULT! 

This special overlay wit! permit you to copy fies, display a directory, kit f»es, and Rst fSes from within 

any program. 

MIGHTY MULTI *'3! be activated if the foBowing conditions are met: 

1. Interrupt service b active. 

2. Simultaneous depression of the : and ; keys 

To exit MIGHTY MULTI: 

1. Press <BREAK> or 

2. Press "!" as the first Input character. 

itowever, upon erft an extraneous character may be present. 

Commands for the various functions are single letters. 

!a - Mighty Multi COPY - Copies ties, <C> 

C fBcofte[:dJ (to] fBetwo[:d] 

Please note the first blink is optional. Although the drive numbers ire cptJcnaL both the flenames are 
mandatory. 
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...';.■■■ MUTIDOS" : 

lb .- Mighty Muiti DIRECTORY - Display diskette directory, <D> 

■; D:n ".'or On :■:>;■'/ * : " : * .'■>'-. 7 ' v" ; ■.'""'' '' - : 

n = 0, t, 2, 3 for the drive number 

n = 0', V, 2', 3' for the opposite side of a. double headed drive. 

\c - Mighty Muttt KILL - Delete fge, <K> 

K fBespec 
id - Mighty Multi LIST - list a file to the display, O 

L fBespec : r 

The listing can be ternporarly suspended if the <SPACE-BAR> is held down. 

II - <JKL> Dump the video contents to the printer. 

<JKL> = The simultaneous depression of the J, K, and L keys. 

This function sends the current contents of the tfcplay to the device defined as the printer. The system will 
not "HANG" if the printer is not ready (MOD 1, MOD lit must press the <BREAK> key). 

Graphic blocks are converted to the "•■ character* If you do not want this to happen, use the "HJK" 
command. 

To prematurely terminate this function, <BREAK>. 

ti - <HJK> Dump display contents to printer, including graphics. 

<}-iJK> = The simultaneous depression of the H } t & K keys. 

This command Is slmfiar to the jKL command, except that graphics characters wfll be sent to the printer 
instead of being converted to V characters. 

Thk command may produce erractic results If your printer is not able to print TRS-80 graphic characters. 
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MULTIDOS 

MULTIDOS SYSrEM DISKETTES 

Mt.fl.Tt DOS requires that ccrtalrt system (/SYS) fUes be present on 2 MULTIDOS disketts, in drive 0, for 
proper operation. Mors than a minimal system is requVed for operation of certain commands and 
functions , 

A MULTIDOS minimum system diskette contains the following f3es: 

DOS/SYS - 3 gratis - 4 3COM to 4 CRTS . 
r.OSO/SYS - 1 trarj ~ 4EO0H to 50FFH. 
00S1/SYS - 1 gran - 4DG0H to 51FFH. 
D052/SYS - 1 gran - 4EO0H to 5JFFH. 
DOS3/SYS - 1 &fan - 4F00H to 50FFH. 

LHR/SYS - 2 grans single density. 2 grans ! P* density. 3 grans double density. This is the 
directory. 

Other MULTIDOS system files which arc requfred to execute certain commands and functions are: 

D0S4/SYS - 1 gran - 4DI8H to 51FFH. Contains DOS error messages. 

DOS5/SY5 - 1 gran - 4D00H to 51FFH. This is the f2e for DEBUG. 

DOS6/5YS - 4 grans - 5200H to 67FFH. Library executor. Contains code for APPEND, AUTO, BUILD, 

CONFIG, DEVICE, DIR, DUMP, FREE, KEYBRD, LINK, LIST, PRINT, ROUTE, SKIP. 
DOS7/5YS - 1 gran - 4D0OH to 51FFH. Mghty-Multi, CMD"C", CMD"Q" and BASIC'S MAN functions. 
DOS8/SYS - 4 grans - 5200H to 67FFH. Library executor for MULTIDOS fibrary commands; ATTRIB, 

CLRDSK. DATE, DDAM (MODEL I), DO, FORMS, HASH, KILL, PATCH, PROT, RENAME, 

RESTOR, SETCOM (MODEL III), TIME, and TOPMEM. 
DOSS/SYS - 5 grans (MODEL !} - 4 grans (MODEL Ml) - 52O0H to 67FFH. Library executor for HELP. 

EDIT/SYS - 1 gran - 4D00H to 51FFH. Performs BASIC global editing. 
RENUM/SYS - 1 gran - 4D0OH TO 51FFH. Performs BASIC renumbering. 
CREF/SYS - 1 gran - 4D00H to 51FFH. Performs BASIC cross reference. 
ERROR/SYS - 1 gran - 4D00H to 51FFH. Displays BASIC error messages. 

MULTIDOS requires a MULTIDOS system diskette to be in drive to load a /CMD f3e from a 

MULTfDOS diskette or an %ien* system diskette. MULTIDOS wil not execute an "alien" DOS Basic. 

MULTIDOS may or may not successfully execute an ^lien* system DOS Bbrary command or uUlity 

pr ogram . 

MULTIDOS requires a system diskette, in drive 0, for disk I/O. Exceptions to this requtement are 
noted in this manual and speclflcaly involve utilities that requ're diskette "swapping". 

Certain machine language programs that are designed specffiealy to use an ^aSen" DOS may not 
execute properly with MULTIDOS- 

Proper "operation" of certain MULTIDOS UTILITIES does not requre a system diskette in drive 0. 

Specific system restraints are covered in the description for the particular utility in the SYSTEM 

UTILITIES section of this manual. MULTIDOS requires that * system diskette be in drive when any 
of the utilities are caSed up. 

MULTIDOS requires certain /SYS fHes present beyond the minimal system for proper operation and 

execution of certain functions. 
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LIBRARY COMMANDS 

The following commini are MULTIDOS ibrary commands and are normaly entered after the "MULTIDOS" 
prompt has been received. 

A mandatory space is required after at Ibrary commands in which there are additional parameters or 
arguments. 

EXAMPLES: 

(1) DATE 09/0l/81<ENTER> 

This establishes September 1, 1981 as the current RAM date. 

(2) DATE<ENTER> 

This displays the current RAM date in the format rnm/dd/yy. 

Multiple library commands are permitted provided a comma follows the last character of a given command, 

EXAMPLES: 

(1) DIR (A),D1R 1{A),DIR 2(A)<ENTER> 

This multi-command will display the <A>Iocation directory for drives 0, 1, and 2. 

(2) RENAME NEW/CMD:2 TO OLD/CMD.D1R 2<ENTER> 

This multi-command will rename "NEW/CMD" on drive 2 to "QLD/CMD*. then puJ! a directory on drive 2. 

Whenever the term "switch" is part of a MULTtDOS Sbrary command Ene, it represents an ON or OFF 
condition. If the "switch" is left out, ON wBI be invoked. 

The acknowledged responses are; 



(V) 


= yes. 


on 


(YES) 


= yes, 


on 


(ON} 


= yes, 


on 



(N) 


= no, off 


(NO) 


= no, off 


{OFF} 


= no, off 



Please note the required "(" and ■}■ surrounding the switch parameter. 
EXAMPLE: 

(1) BREAK (N)<ENTER> 

(2) BREAK (Y)<ENTER> or BR£AK<ENTER> 

Example one w3l disable the "BREAK* key, and example two wil enable the "BREAK" key. 
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LIBRARY CO&SMANDS 

APPEND Appends a fit to the end of another fie. 

APPEND fSe-specl to f3espec2<ENTER> 

APPEND ?.!!ows you to add flespecl to the end of ftlespecZ fUespecl is not affected by this command. 

NOTE; The disk which contains f8espec2, must not be write protected and must have at least enough free 
ip?xt to lengthen iTTe£pcc2 by the length of frlespeel, and both f?especs most have the same logical record 

ier-Jh, 

Be very careful with Basic programs. Both should be ASCII files and the Ene numbers in flespecl should be 

h.^'icr than those of fifespec2. 

EXAMPLE: 

APPEND CLASS2/TXT to 5TUDENTS/TXT<£NTER> 

The file STUDENTS/TXT will have the contents of fie CLASS2/TXT 
added to the end. The fHe CLASS2/TXT wBI remain unchanged. 

APPEND NEXT/TXT :7 to BEFORE/TXT :1<ENTER> 

The fOe NEXT/TXT on drive 2 wt!l be appended to the fie BEFORE/TXT on drive 1. 

NOTE: APPEND does not prompt you for diskette mounts. AG diskettes must be mounted. 

ATTRIB Assigns filespec attributes. 

ATTRIB fikspec (param[,param_])<ENTER> 

This command sets file protection attributes. 

param Can be any of the following: 

I The file is invisible to the norma! directory corrmand. 

V The file is visible to the normal directory corrmand. 

A=pw pw = The new access password. 

U~pw pw = The new update pas swor d . 

P-level level = The protection level. 

LEVEL VALUE ACCESS PASSWORD PRIVILEGE 



def au 1 t 





KILL 


1 


RENAME 


2 


not used 


3 


WRITE 


4 


READ 


5 


EXEC 


6 


NCNE 


7 



TOTAL ACCESS 

TOTAL ACCESS 

RENAME, WRITE, READ, EXECUTE 

WRITE', READ, EXECUTE 

V.RITE, READ, EXECUTE 

READ, EXECUTE 

EXECUTE ONLY 

LOCKED OUT 
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Protection level with a value of usually occurs when a diskette is PROTected with the master password. 
This W01 set both the access and update password to the diskette's master password which must be use 
when setting the protection level to 2 different value. The master password on your MULTIDOS diskette is 
PASSWORD. 

If a fie has a protection level of WRITE (4), it can be accessed by any of the levefc equal to or higher 
than WRITE, i.e. READ, EXECUTE, with the use of the access password. The fie cannot be RENAMEd or 
KILLed without the update password. 

The access attribution does not require an update or protection level attribute. Files with access attribution 
require the access password for any operation with the file. 

All files naturally have an access and update password. This default password is 8 blanks (spaces) if none *ts 
specified. With the default password of 8 blanks, you do not need to enter the password. The "DiR" 
command will display the protection level for al fies which have 2 non-blank update password, with its 
protection level indicated by "P^X 8 to the right of the fBename, where X ts the protection level value. 

EXAMPLES: 

(1) ATTRIB FILEA/BAS (A= U=SAM,P=READ)<ENTER> 

ilLEA/BAS can be executed, loaded, and read without passwords. To write to the fie, RENAME, or KILL 
the fBe, the password "SAM" must be used. 

(2) ATTRIB F1LEB/BAS (V)<ENTER> 

F1LEB/BAS is visible and wPl be displayed when the "DIR" command is issued. 



AUTO Automatic command after reset. 

AUTO[ DOSCMD][incfeed DOSCMD]<ENTER> 

AUTO provides for automatic operation of one or more MULTIDOS commands or executable command fies 
upon power-up The commands or executable command fi« are executed in sequence immediately after 
power-upt 

DOSCMD rs any vald MULTIDOS Ibrary command or a fiespec for an executable command fie. 

MULTIDOS can exectute multiple AUTO comands. To set up miitipfe AUTO commands, insert a linefeed 
{down arrow) between each MULTIDOS command or fUespec you want executed upon power-up. This wBI 
show each AUTO command prior to execution. 

EXAMPLE: 

AUTO DiR<T> 

FREE<LF> 

BASIC<ENTER> 

However you may enter 2 miiti-AUTO command by separating the commands with commas. This will onry 
show the mutti-AUTO command once. 
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EXAMRE: 

AUTO DIR,FREE,BAS1C<ENTER> 

A maximum of 32 characters after the "AUTO " including blanks, linefeeds, and the terminating <ENTER> 
are allowed If your entry exceeds 31 characters, the 32nd character wilt be replaced with an <ENTER> 

and iny additional characters wilt be disregarded. 

Sir'fCe the 'AUTO" command writes to the directory, the diskette must not be write protected when the 
"AUTO" command is set up or removed. 

To delete an automatic power-up sequence, type: 

AUTO<ENTER> 
To suppress an automatic "AUTO" function, hold down the "ENTER" key during power-up. 
To query an AUTO command, type: 

AUTO ?<ENTER> 
To execute an AUTO command, without re-booting, type: 

AUTO %<ENTER> 

NOTE: This command will convert a multiple AUTO command to a miiti-AUTO command for this 
execution. 

EXAMPLES : 

(1 ) AUTO DIR<tNTER> 

On future power-ups the directory will automatically be displayed after 'DiR' appears on the display. 

{ 2 ) AUTO 

CLOCK <LF> 

BASIC RUN" TEST" <ENTER> 

On future power-ups the real time clock w81 be displayed, BASIC wBI be baded, the program "TEST" wBi 
load and run. You will see CLOCK" displayed, then 'BASIC'RUN'TEST* ' 

To inhfeit the suppression of the "AUTO" function, key in in "1" (exclamation mark - shifted "l" on your 
keyboard} as the first character after the mandatory space foBowing "AUTO". Thb command syntax will 
bypass the DAT E entry r equirement on power-ups. 

EXAMPLE: 

AUTO !BAS!C<LNTER> 

On subsequent power ups, BASIC wfil be loaded after 'BASIC k displayed, whether the <ENTER> key b 

held down or not. 
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To Inhibit displaying the AUTO DOSCMD(s), place a *§* (pound sign, shifted "3" on your keyboard) in front 
of the first DOSCMD. 

EXAMPLE: 

AUTO J j6AS!C<ENT£R> 

On subsequent power ups BASIC wili be loaded but not displayed on the screen. 

AUTO S^BASiC 

This is the proper combination of the extended "I" and "g* AUTO functions. The M i" designator is on!y 
recognized if it is the first character after the mandatory blank following AUTO. The *§* designator b 
recognized if it immediately precedes the command. 



BUNK Disables/enables the blnking cursor. 

BLINK[ switch] ^NTER> 

BOOT Resets the computer. 

This command will cause a "system* {4000 he* - 51FF hex ) software reset 

BREAK Dbables/erubles the break key, 

BREAK[ switch] <ENTER> 

BULD Creates a "DO" fie. 

BULD f2espec<ENTER> 

BULD creates a disk fie to store a series of keystrokes for execution by the DO command. The data in 
the dfek file h interpreted by the DO command as keyboard entries. 

This command will create 'flespec\ if it does not exist, or add to ^fiespec 1 , if ft exists, for "DO" 
execution. The maximum input Ene ts 63 characters. 

To BULD a 'DO 1 fie folow these steps: 

1. Type BULD flespec where fiespec is the name of the fie for "DO" execution. 

2. The prompt Type in up to 63 keystrokes. 1 w2! appear. 

3. Enter the text. You may enter up to 63 characters before you need to press <ENTER>. 

4. Keys are stored to the fie exactly as typed. Exceptions are noted below. 

5. Continue steps 2 thru 4 until the "DO" fie k "BULT". 

5. To termirute a current "BULD" and close the fie, press the "BREAK* key. 
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If no extension is specified in the fllespec, "/IDO" rs used as the extension by default, 

MULT1DOS has 3 special "BUILD" characters each of which h recognized only rf it is the first character in 
a "BUILD" Erie. These characters are «#*, "$■, and *%*. 

The n #" character k used to pause execution of a "DO* fie. If a message is desired, type it in 
immediately after the r f* character. 

EXAMPLES: 

#<ENTER> - Pauses "DO" and waits until a "SHIFT" key is pressed. 

#INSERT DISK NUMBER 77<ENT£R> = Pauses "DO n after displaying the message: 
'INSERT DISK NUMBER 77 1 . 

The T character b used to suppress video output during "DO 1 without a 'pause', ff text follows the "t* 
character it will pause the "DO* file after being displayed. 

Z X AMPLE : 

i<t.NTER> = Suppresses video output and continues "DO" ffie. 

^Thrs is the beginning of darknessKENTER> 

Wil display the message Thb is the beginning of darkness!', wart for a <SHIFT>, then turn off future 
video updates until a DO" file closes. 

The video dbpiay rs turned on whenever the current "DO* fBe b completed regardless if it » a nested 
''DO 11 within a "DO" which turned off the video display. 

The *%* character is used to display text only, it is used to display miiti-fine messages, which are entered 
one line at a time. If no text foSows the »%", DOS will try to execute r % r . Since % b not a vaid DOS 
command the "REDO" message wti\ be displayed and the "DO* fie continued. 

EXAMPLE: 

%We the people of the United States, in Order to form a more<ENTER> 
^perfect Union, establsh justice, insure domestic TranquIity,<ENTER> 
%provide for the common defence, promote the general Welfare, <ENTER> 
*:and secure the Blessings of Liberty to ourselves and our<EMTER> 
^Posterity, do ordain and estabish this Constitution for the<ENTER> 
%United States of America,<ENTER> 

NOTE: The *%" character b required on each comment fine. 
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Special BULD characters are summarized in the foBowing table: 

BUILD Character Action description 

# pause and waits for "SHIFT" key 

press prior to continuing 

ftzzzzz pause after displaying zzzzz and 

wait for "SHIFT" key press prior 
to cont t nuirtg 

$ turn off video 

Jzzzzz turn off video after displaying 

message zzzzz and wait for a 
"SHIFT" key press to continue 

%zzzzz display zzzzz and continue 

EXAMPLE of BUILDing a file for DO execution: 

BUILD BLAST/ IDO<ENTER> 

CLS<ENTER> 

%LQADING BASIC<ENTER> 

BASIC 3,61440<ENTER> 

CLS<ENTER> 

*GET READY FOR A BLAST !<ENTER> 

RUN" BLAST / BAS " <ENTER> 

<BREAK> 

The above example shows that when DO 1AST is entered from MULTIDOS command mode that: The 
screen will clear. The message LOADING BASIC will appear. BASIC w3l be loaded with 3 ffle buffers and 
memory set to 6144a The screen will clear. The message "GET READY FOR A aAST V will appear. The 
program "BLAST/BAS" wB! load and execute. 



CLEAR Zeroes Random Access Memory (RAM). 

CLEAR<ENTER> 

CLEAR zeroes RAM from 5200H to TOPMEM. The Bmtt of free memory, caBed "TOPMEM", is the address 

pointed to by the contents of 4049H - 4MAH MODEL I, and 44T1H - 4412H MODEL ML 

EXAMFLE: 

(1) CLEAR<ENTER> (MODEL I) 

ff the contents of 4049H & 404AH are FFH and 
FDH respectively, the above command wSI cause aS 
bytes from 52O0H through FDFFH to be set to 00. 
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CLOCK Displays ihe real time clock. 

CLOCK[ switch]<ENTER> 

The ON mode forces the real-time clock to be displayed at the top right of the video display. 

As long as interrupts are enabled, the clock will be updated for each second, minute, and hour. After 
23:59:59 the clock will be reset to 00:00:00 and the date will be incremented. Also note that certain 
functions such as disk i/O and certain programs stich as SCRIPS!! cause the interrupts to be turned cff. 
This affects the accuracy of the clock. 

EXAMPLES: 

(1) CLOCK {OFF)<ENTER> 

The display of the clock will be disc on tin lied. 

(2) CLOCK (ON)<ENTER> 
The clock wDI be displayed. 

The RAM storage for the time rs in the following locations: 

Contents MODEL I MODEL 111 

hours 4043H 4219H 

minutes 4042H 421SH 

seconds 4041H 4217H 

CLRDSK Zeroes unused granules. 

CLRDSK [{:}d] 

This command wfl! "clean up" unassigned granules on the diskette specified: This h useful when you want to 
give a diskette to someone but do not want specific deleted ffles from being recovered. Thb command is 
not necessary for BACKUP, since BACKUP onh/ copies assigned granules. 

EXAMPLE: 

CLRDSK :2<ENTER> 
This wHI zero aB unused granules on the diskette mounted in drive 2. 

CLS Clear the screen. 

This command simply clears the screen. This command is very useful in a f DO" fie to clear the screen 
between large comments. 
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CONFIG Default power-up drive attributes. >■■ 

CONFIG [[:}[drn] (param[jaramJ)]<ENTER> 

par am meaning 

dm drtvespec {not In parenthesis) 

STEP = nn nn is dm track to track access speed 

DENSlTY=q q is the default density for drn upon power-up. 

SIDES=ss ss in the number of sides on a disk drive. 

Sets individual drive stepping speeds and initial density. 

The norma! side, side zero, b accessed by specifying the drive number without any modifier. Side one Is 
accessed by specifying the drive number immediately followed with an apostrophe. (This Is the character 
obtained by keying In shifted 7 - Analogous to PRIME). 

EXAMPLE: 

CONFIG :2 {STEP=6,DENSITY=P}<ENTER> 

Wil write this info onto drive zero diskette {system disk), set RAM configuration for drive 2, and remove 
all SKIP's. The diskette m drive zero must not be write protected. 

Syntax is forgiving, only the first two letters are considered. 

i.e. CONFIG 2{ST=6,DE ; =P) b equivalent to the above example. 

The stepping speeds are the track to track access speeds. The optional speeds aval able are 6, 12, 20, and 
40 mS {30mS for MODEL 111). 

NOTE: The 6mS speed is only attainable ki the MODEL I with a double density hardware modification. The 
density's avaiable are: S - single density, P = DBLDOS (tm) density, and D = double density. 

CONFIG command has three other p ar2me ter specifications. They are: 

CONFlG<ENTER> echo's system disk's configuration. 

CONFIG (?)<ENTER> echo's RAM's current configuration. 

CONFIG (X)<ENTER> writes RAM's configuration onto the system diskette and removes al SKIP'S. 



DATE Sets the date. 

DATE mm/dd/yy<ENTER> 
DATE<ENTER> 

Thb command alows you to set the date. If you use the format DATE<ENTER>, MULTIDOS wHl display 
the date and time currently stored In RAM. The date is set to 00/00/00 at power-on. 
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However, at a non-powerup reboot, the system wttl retain the date previously set in RAM. Since you are 
prompted to input the DATE during power-up, the DATE does not have to be set again untB the next 
power-up. MULTIDOS dates the ties to the current RAM date; therefore, it is recommended that you set 
the DATE during power-ups. 

If you do not want the DATE prompt to appear during future power-ups, use the AUTO I command. 
There does not have to be anything foHowmg the "i* character. 



DDAM Directory Data Address Marks (Model I onfy) 

DDAM[ |:]d) (type)<ENTER> 

DDAM afters tht Data Address Marks on a single density diskette's directory sectors. 

d = drive number 

type = O for 1771 TDC, MODEL I - TRSDOS (tm), NEWDOS/2.1, etc compatible, 
N for 1791/1793 FDC, MODEL 111 type. 

This command does NOT un "read protect" a directory. 

The address marks placed on a single density diskette by MULTtDOS cannot be easily read by TRSDOS, 

NEWDOS (not NEWDOS/SO), and LLTRADOS. If you must write to an "aBen" single density operating 

system, use DDAM to convert the address marks after writing. This will enable the "alien" system to easily 

read itsetf. Converted cr non-converted address marks for the "alien" system can be easBy r',id by 
MULTIDOS. 

The "Deleted Data Mark' is used for MODEL I to/from MODEL Mi compatibiity. If you do not intend to 
work with a MODEL III and want to use the "alien' system compatible address marks then patch a backup 
system diskette as follows: 

Single Density: PATCH DOS/SYS (REC=1 , BYTE=1 76 ) t2 

Double Density: PATCH DOS/SYS (REC=20 , BYTE=1 76 ) 62 

n P" Density PATOt DOS/SYS (REC=8 ,BYTE=1 76} 62 

NOTE: The distributed value for this byte is 230d. The 62 will defeat the DDAM (N) function. 



DEAD Software power on. 

Al! memory from 4000H upward w3I be set to 00, and the system will reset. 
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DFBUG Real time debugger. 

DE8UG[ switch]<ENTER> 

DEBUG is a real-time debugging package for use with machine language programs. DEBUG lets you 
examine and alter the contents of RAM and the Z-80 registers, jump to a specified address and begin 
execution with optional breakpoints, single stepping or perform CALL'S, etc. 

AM values are required to be in hexadecimal form without the "H" suffix. 

Once the debugging facBity is enabled - via DEBUG (ON) - it does not load and execute untl one of the 
following conditions occurs: 

1. If the interrupts are enabled and the <SHIFT><BREAK> keys, <LEFT>-<SHIFT><BREAK> 

MODEL III, are pressed simultaneously. 

2. After an executable program, with protection level of less than EXEC, is loaded and before its 

first instruction is executed. 



DEBUG offers three display formats: 

(1) Register display only on the right hand side on the screen. 

(2) Register display with indirect RAM plus any 64-byte "page" of RAM. 

(3) full screen, 256-byte "page* of RAM. 

When DEBUG is initially loaded, the display will be blank. Press <0> to enable the display. 

In the register display formats, DEBUG displays al the Z-80 registers, organized for interpretation either as 

two S-bit registers or as 16-bit register pairs. Since most programs use several sets of register pairs as 

indirect pointers or indexing registers, 16 bytes of indirect data are presented with each register pair in 

format 2. 

Each of the flag registers fa shown with an ASCII representation of its flag bits. For tr*ese registers, the 
hex contents of the flag register is displayed, along with a bit-by-blt afchabetic code which makes it easier 
to interpret the flag status. For example, bit (rightmost bit) fa the carry flag, so the afchabetic code 
shows an C in that positron whenever the carry flag fa "set". 

Table of codes for aB the flag bits: 

Bitstatus Ifset 

7 Sign S 

6 Zero Z 

5 Unused space always 

4 Ha! f-carry H 

3 Unused space always 

2 Par i ty/over f I ow P 

1 Add/Subtract N 

Carry C 

NOTE: Since DEBUG loads into the overlay are of RAM (4DO0H to 51FFH), you cannot use it with 
MU-TIDOS overlays or utilities which load below 520GH. 
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To return to the point where you entered DEBUG, provided you have not altered the contents of the PC 
or SP registers, type G<ENTER>. 

To begin execution at the address in the PC register type G<ENTER>. 



( 



DEBUG Commands 

Commands are executed as soon as you press the specified command key or are executed onty when you 
press <SPACE> or <ENTER>, as tndcated below. 



Command 
C 

Dqqqq 

E 

F 



Entry 
Requi red 



none 



<SPACE> 



none 



none 



G[iiJj[,kkkk]]<ENTER> 



Mfcccc] 



none 
<SPACE> 



N 


none 





none 


P 


none 


Rrp aaaa 


<SPACE> 


Q 


none 


S 


none 


U 


none 



Operation Performed 

Single-steps next instruction, with CALLS executed in 
full. 

Sets memory display starting address to qqqq in register 
display mode, in full screen mode, sets starting address 
to qqOO so qqqq Is contained In display. 

Produces continuous ■C" eonmands until <SPACE> Is pressed. 

Disables all display formats. 

Place jjjj in PC register and executes with optional 
breakpoint at kkkfc. 

Single- steps next Instruct ion. 

Sets the current modification address to cccc. 
Modification information wl II be di splayed in the lower 
left of the screen.' If cccc ts omitted, the last 
modification address wl 1 1 be used for cccc. If cccc Is 
currently In the display, It wi II be over I aye d by a 
transparent cursor, (see next page). 

Provides continuous "I" commands until <SPACE> is pressed. 

Enables the display formats. 

Set display to register only mode (1). 

Loads register pair rp with the value aaaa. 

Sets display to previous format 2 or 3. 

Sets display to full screen memory mode (3). 

Dynamic display update mode. Lets you observe the 
execution of a foreground task. Press <SPACE> to exit this 
mode. 
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Corona nd 


Require 


X 


none 


up arrow 


none 


down arrow 


none 
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Entry 

Required Operation Performed 

■■■■■' •..■..:'-■-■■;■■".:... " ■ J 

Sets display to register mode (2). 
Decrements memory display by one page. 
Increments memory display by one page. 

NOTE: If you make an error whle typing an address, Just type the correct address immediately after the 
incorrect address. DEBUG will only look at the last four characters entered. 

EXAMPLE: 

DFAE944<SPACE> 
Wll display the page of memory containing address E944, 

The "M" command detail- 
Any time you wish to after the contents of a memory location, type Maaaa then <«PACE>. This sets the 
memory modification address to aaaa and puts a memory modification prompt In the tower left corner of 
the display. To modify the contents of aaaa, type the new, two-digit contents and press <SPACE>. The 
display will then be updated, and DEBUG will increment the modification address by one. 

To increment the modfication address and leave the current address unchanged, type <SPACE> or 
<COMMA>. To decrement the modification address and leave the current address unchanged, press the 
back-arrow. Pressing any non-hex key wBI exit the modfy memory mode. 

To disable DEBUG, type: 

DEBUG switch<£NTER> where switch = (N), or (NO), or (OFF) 



DEVICE List current I/O devices. 

This command Ists: K1=keyboard, DO=«deo display, PR=Ine printer, RI=RS 232-C input (Model III only), 
RO=RS 232-C output (Model Ml only), and their routine entry points. These are the defined I/O devices. 
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DIR Dbplay a specified diskette directory. 

DtR[ [:}d[(optt 1 opt-])]<ENTER> 
opt = A, t, K t P, or S 

The -P- option wll direct the output .to the printer as wel as the displ.y. if the printer b not ready the 

system will direct the output to the video display only. 

The -K- option wBI display -KU£D- ties provided the directory entry location was not overwritten. 

The -I" option will dfeptay the fles with the "I" attribute as wel as visible files. 

The "S" option will dbplay the system fles as wel as visible fies. 

Use of the -A- option will cause the directory display for each fie to be expanded to incWe the level of 

fie. 

You may enter as many options as you wish. 

The protection level wi.1 not be indicated^ fi.es with the update password blank. Protection levels are 

designated as folows: 

7 = NO ACCESS 3 = (unassigned) 

6 = EXECUTE 2 = RENAME 

5 = READ 1 = KILL 

4 = WRITE = (unassigned) = FULL 

EXAMPLE: 

DIR 3(A,P)<ENTER> 

The folowing type of output will go to both the 
display and the printer: 

?;;ina^" ,ttd "' 09 DaU 81 'Tsec tr ^' %.r^"™ 

SSJm **> °?> 01 / 82 23 -° 4/254 ; III I 

^ruTcio P=6 09/01/82 22,0 9/250 1 256 2 

A maximum of eleven Hoes of fies wtt be djxayed at one time, To db^ay the next fie press <SPAC*>, 
or to dbpiay * maximum of eleven additional fles press <ENTER>. 
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By pressing a single key you car). display a directory of .*, mounted tfiskette. The key must be the first 
keystroke atter <ENTER> or <BREAK>. The keystrokes are: 

"0" = DIR 

"1 1 = DIR 1 

w 2* = DIR 2 

"3* = DIR 3 v ,r 



DO Substitute disk fSe for keyboard input 

DO flespec<ENTER> 

This command executes fiespec which was previously created with "BUID". The extension "/IDO" wll be 
appended to filespec if no extension Is entered. 

You can nest DO'S until you run out of memory. You would probably crash before you ran out of memory. 

The "DO" fie buffer Is loaded into TOPMEM to TOPMEM - 290 decimal (122H). TOPMEM should be set 
BEFORE the "DO" fie is executed, when you want to load a machine object code Into high memory. The 
use of the muIU-AUTO command, or the multple AUTO command wll permit you to accomplish this task 
during power-ups. 

EXAMPLE: 

AUTO TOPMEM xxxxx,DO STARTER<ENTER> 

or AUTO TOPMEM xxxxx<F> 
DO STARTER<ENTER> 

Please note that you may wipe out the "DO" buffer If you attempt to set TOPMEM from within the "DO" 
ffle. 



DUMP Transfer RAM contents to disk fie. 

DUMP fiespec {START=X'ssss'^ND=X'eeee'[,TRA=X , tttf ][,ClM]{,TITLEl}<ENTER> 
ssss, eeee, tttt are 4 cfglt hexadecimal addresses 

DUMP wilt transfer the contents of memory starting at ssss and ending at eeee to cfsk. The dump 
command inserts the extension "CMD" if none was specified in fiespec 

eeee must be greater than ssss. 

tttt is optional. If entered, it specifies the entry point for execution of the fie. If no entry point is 
specified the system will default to 402DH, the MULTIDOS command mode, 

CIM specifies direct transfer to dhkette sectors without 'load marks*. 
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TITLE causes DUMP to place a title block at the beginning of the fle's contents. 

If fllespec already exists it will be replaced by the contents of the specffled area In RAM. 

EXAMPLES: 

(1) DUMP V (START=X<4000',END=X'4400 , ,CIM)<ENTER> 

The contents of memory locations 4OO0H through 4400H wBI be transfered to a disk fBe named V/CIM. 

(2) DUMP D (START=XTD0O T f END=X , FFFF , ,TRA=X'FE0O T )<ENTER> 

The contents of memory locations FDOOH through FFFFH wil be transferred to a disk fBe named D/CMD. 
If MULTIDOS attempts to execute this file it wDI start execution at FEOOH. 

FORMS Sets printout parameters. 

FORMS[ (param][,paramt H,param2}]<ENTER> 

Where par am: 

t Intlalizes tine counter and character counter to zero. 

W=XXX XXX=1 to 255 which is the maximum width of print line in characters, 255 

inhibi ts * FORMS ' character counter. 
P=XXX XXX=1 to 255 which Is the page length in print lines. 
T=XXX XXX=1 to 255 which is the printed TEXT in print lines. 

S=XXX XXX=1 to 127 which is the blank spaces between blocks of printed TEXT. 
X Writes out to the system diskette, the current W, P, and T values, for 

defaul t parameters on subsequent power-up s. The diskette in drive zero 

must not be write protected. 
N=nn nn - nulls after linefeed. 
L Send linefeed after carriage return. 
C direct printer output to RS-232-C {Model ill only). (Affects a psuedo 

ROUTE PR RO except the data is formatted in accordance with the FORMS 

parameters .) 

Only 2 of P,T, & S are required for setup. Priority is P, T, then S. 
EXAMPLE: 

FORMS (l,W=80,T=60,P=66) 

1. The Dne and character counters are set to zero. 

2. The print width b 80 characters. 

3. The printed text length h 60 lines. 

4. The page length Is 66 fines. 

NOTE: If "P 1 and ■T" are the same, pagination Is Inhibited. 

[f »w" = 255 then no carriage return H sent after a specific character count. The width command is 
EXACT in MULTIDOS, no adjustments are necessary. MULTIDOS is distributed with W=255> P=66, and T=<6 
(no pagination nor character counting). 
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FORMS will always recognize i CHR$[11) as » linefeed without a carriage return {vertical tab one line). 
This can be used to send linefeeds to certain printers which do not respond to mJtipIe linefeed characters. . 

A CHR$(12):WlU generate a formfeed. A CHR$(11) wHI generate a line feed. ; 
A CHR$(13) will generate a carriage return. 

When the ESC character, CHR$(27), (s encountered, FORMS wll not count this nor the next character as 
one of the characters to be counted for page width, nor wHI the next character be recognized as a stand 
alone character. ke. LPRINT CHR$(27)+CHR$(12). Thb wHI send BOTH codes to the printer without 
generating a formfeed, and leave the character counter where tt was before this ESC pair was sent to the 
printer. 

The RAM address for these values are as folows: 

Print lines per page. (P) NOT directly available. 

Printed text lines. (T) 4028H 

Line counter. 4029H 

Width of text. (W) 402AH 

Character counter. 402BH 

Spaces between pages. (S) lower 7 bits of 402CH 

Byte 402CH high bh h the pagination bit If this bit is set then pagination b enabled, And the (P) value is 
the sum of 4028H and the lower 7 bits of 402CH. 

FORMS <ENTER> 

WII display the current FORMS parameters. 

Whenever the FORMS command b entered the current values are echoed on the display. However, if the 
"I" parameter b specified, the dbpiay wBI not echo the settings. Thk b useful for initiafizing the FORMS 
parameters from within SUPERBAStC without messing up the display. 



FREE Dbplays the number of avalable fJe spaces, free granules, and klobytes of disk space on al 

mounted diskettes. 

FREE<ENTER> 

Thb command dbfrfays the drive number, the dbkette»s name and date, the number of avalable ffles 
remaining, and the number of free granules and the equivalent K bytes (1024 bytes) on each mounted 
dblcette. FREE wil total al the directory space, and the dbkette space and dbpiay thb totaL 

HASH Returns HASH code of flespec 

HASH BASIC/CMD<ENTER> 

Returns: Hash code = FO 

The hash code byte fc the byte on the <H>ash <!>ndex <T>abIe (HIT) located at the directory track. Several 
people use the Jargon "HIT* byte. 
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HELP Provides a brief explanation of UBrary commands. 

HELP[ COMMAND]<ENTER> 

Thh command w«l assist you In using the MLLTIDOS LIBrary commands along with the format required to 
execute each command. 

If COMMAND is omitted or Incorrect, MULTIDOS will provide a Hit of the avalable COMMANDS which are 
in the HELP fBe. 



KEYBRD Set keyboard attributes. 



KEYBRD[ ([function = q] [ ,f unc t ion2 = q])]<ENTER> 

q = "YES" or «Y« f If the function Is desired. "NO" or "N" ( if the function Is not 
des i red. 

function is defined by: 

B = bl Ink ing cursor . 

C = <CLEAR> key. 

E = Epson graphics converter. 

G = Keyboard graphics converter. 

K = <BREAK> key. 

L = lowercase. (MODEL I only) 

R = repeat keyboard. (MODEL I only) 

ind one function which does not use a "switch" but requires a decimal value is : 
W^nnn where nnn Is the decimal value of the cursor character. 

None, one or more functions may be specified. If any KEYBRD attributes are changed they are updated to 
the system disk immediately. However, they do not go Into affect until a future reboot/power-up of the 
system diskette, 

<E' function, the Epson graphics converter, when enabled, adds 32d to the vakie of each graphics character 
sent to the device defined as the printer. This offset Is required by Epson printers that print TRS-80 
graphic characters. 

On the MODEL 1, If the "G* function is set to ON, then on rebooVpower-up, the keyboard graphics driver 
Is loaded into high memory and the TOPMEM address h reset. (GR/CMD need not be present on disk,) 
The MODEL 111 self-configures DOS for keyboard graphics and does not use hfeh memory. 

if the *G l function is set to ON, the <SH!FT> £ <CLEAR> keys pressed simultaneous are used to switch 
the keyboard between graphics entry and normal (ASCII) entry modes. Refer to the keyboard graphics 
chart at the end of the UBRARY COMMANDS section of thb manual for graphic key descriptions. 

Syntax h forgiving - only the first letter is considered. KEYBRD (eQs4X^EP), the same as KEYBRD (e^V), 
wit configure DOS such that the Epson graphics converter is set to ON. 
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KEYBRD<ENTER> echoes system disk's current KEYBRD attributes. 
EXAMPLE: 

KEYBRD (K=N,C=N,B=Y,W^76) 
On future reboots/power-ups: 

1. The <BREAK> key b defeated. 

2. The i <C1£AR> key b defeated, 

3. The blnklng cursor b on. 

4. The cursor character is 176 decimal. 



KU. Delete a flespec 

KIIL flespec<ENTER> 

This command wit reset the directory "in use 1 bits and dealocate diskette space previously al oca ted to this 
fflespec The diskette which contains the flespec must not have its write protect notch covered. If a 
drivespec is not included in the flespec^ the system wBI search for the first drive containing the flespec 
and delete it. 



LIB Displays the MULTIDOS operating system library commands. 

UB<ENTER> 

The ibrary commands load between hexadecimal 52O0H and 67FFH except 'BUNK', 'BOOT 1 , 'BREAK 1 , 
"CLEAR 1 , •CLOCK', •OS', 'DEAD', 'DEBUG', UB 1 , LOAD' {MOD III), and 'VERIFY 1 , which are contained in 
DOS1/SYS (4D0CH to 51FFH), 



LINK Simultaneous output. 

The four possible inputs are: 

LINK PR DO<ENTER> 
UNK DO PR<ENTER> 
LINK RO DO<ENTER> 
UNK RO PR<ENTER> 

LINK PR DO wll send to the printer whatever goes to the display. 

UNK DO PR wll send to the dfeplay whatever goes to the printer. 

UNK RO DO wll send to the dtspiay whatever goes to the RS-232 communications board (MODEL HI 

only). 

UNK RO PR wll send to the printer whatever goes to the RS-232 communications board (MODEL HI 

only). 
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To un-LINK all or any UNKed devices: v s . ' -- 

UNK<ENTER> 

LIST Display diskette fie. 

UST flespec<ENTER> 

This command lists a fie on the display, tf the fie contains control codes, the display of the control codes 
is suppressed. The <BREAK> key will terminate the listing of a fie. The simultaneous pressing of 
<SHIFT><@> wDI pauuse the display untl any key b pressed. 



LOAD Place an object fie from diskette Into RAM. 

LOAD fiespec<ENTER> 

This command loads the specified fiespec into RAM and returns control to MUXIDOS. With MIATIDOS, you 
can load down to memory location 52O0H and retain the operating system. However, If your program loads 
below 6800H, you cannot use some MULT1DOS Ibrary commands without overlaying your program. 



PATCH Modfy the contents of a diskette fie. 

PATCH fiespec (REOw[,BYTE=yy]} bl[;b2H;b3H;b4]<ENTER> 

nn = physical record in 'fiespec' NOTE: The first record is G. 

yy = relative byte in physical record 'nn'. This input can be in decimal (0 to 255) or hexadecimal (XW to 
XTF'). 

b1,b2,b3,b4,etc = DECIMAL vabe of replacement bytes. 

The physical record wSI automaticaly advance if I b2* up causes the relative byte to exceed 255 decimal 

Thfc command wBi permit you to make changes to ANY disk fie. 

in order to PATCH a fie you need to know the physical [NOT logical} record to reference, and the 
relative byte in that sector. PATCH automaticaly ignores the logical record, and password protection on al 
fies. The first record of a fie is (zero). 
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PRINT Printout * fie onto the printer. 

PRINT f!espec<ENTER» .... ..- ; 

Thb command wll print out the fflespec onto the tine printer. 

NOTE: If the fie to be printed V 'riot' 7 saved in ASCII formal; your printout and printer behavior b 
unpredictable, as many of the characters may be interpreted as linefeeds, tabs, form feeds, etc. 

PROT 

PROT[ [:]d] {(paramI,param...l)]<ENTER> 
par am meaning 

LOCK assign WASTER PASSWORD to all user files 
UNLOCK remove all passwords from user files 

PW change the MASTER PASSWORD 

DATE update ail files to current RAM date 
(used with LOCK or UNLOCK) 

This command will change the diskette MASTER PASSWORD or lock/unlock al visfele and non^ystem fles 
on the diskette. If drivespec b not Included, drive wli be used. The drivespec referenced must not have 
Its write protect notch covered. 

EXAMPLE: 

PROT (LOCK)<ENTER> 

This w«l assign the MASTER PASSWORD to al user flies 
{ non-system and visible fles ). 

The master PASSWORD on your MULTIDOS dbkette b PASSWORD. 

If no parameters are entered with PROT, you wit be prompted to change the diskette* name (ID) and the 
date. There b NO checking for a vald name or date; use what you wishl If you only want tochange one 
of the name/date pair, simply <ENTER> for the one not to be changed. To prematurely exit this command, 
press <BREAK>. 



RENAME Change flename. 

RENAME [$l«especl [to] «espec2<ENTER> 

Thb command will change the name of flespecl to flespecT. if the optional «$• b specified then the 
renamed file's date wil be changed to the current RAM date. 

flespec2 wll contain the protection level, password, and directory attributes of flespecl. An error message 
wlTappear If the name of f.espec2 already exists on the dbkette. ffiespec2 should not have a dnvespec 
specified, and the dbkette with the flespecs must not be write protected. 
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RESTOR Recover a KIlLed fllespec 

RESTOR fBespec[:)[d]<ENTER> 

This command will let you attempt to recover a f3e Inadvertently klled. tf the fie space on diskette has 
been re-assigned you will be notified of this condition and restoration wBI not take place. 

The drive number Is mandatory for RESTOR to work properly. Since MULTIDOS uses the next unused 
directory entry for a new file on a fjven diskette, you should recover a file prior to writing a new fie to 
this diskette. 



ROUTE Redirects one device to another. 

ROUTE will modify the driver address of a device, to allow the system to redirect caDs to this device. 

The folowing are the MULTIDOS devices aval able. 

K! = keyboard Rl = R-232-C Input (MODEL 111 only) 

DO = display PR = printer 

RO = RS-232-C output {MODEL 111 only) 

EXAMPLE: 

ROUTE PR DO<ENTER> 

Wll send to the display anything directed to the printer. 

ROUTE DO PR<ENTER> 

Wll send to the printer anything directed to the dbptay. 

To un-ROUTE you simply enter: 
ROUTE<ENTER> 



SETCOM Initialzes RS-232-C, and sets parameters. 

(Model III only.) 

SETCCM[ ([BAUD=rr]I, S eI][,W0RD=ww]hSTOP=][ ) psw][,tsw][,DTR][,RTSn > wsw])]<ENTER> 

rr = BAUD rate. Permitted are: 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 

2400, 3600, 4800, 7200, 9600, or 19200. 
sel = OOD or EVEN 

ww = Word length. Permitted are: 5, 6, 7, or 8. 
bb = Stop bits. Permitted are: 1 or 2. 
psw = Parity Switch, (parity on/off). 

Permitted are: PE for parity enabled, and PD for parity disabled, 
tsw = Transmit switch. TE = Transmitter enabled, TD = Transmitter disabled. 
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DTR If entered'sets DTR hignV-otnef^ V , 

RTS If entered sets RTS Hlgh^th«rw1 SftRTS wil 1/ be~ Jet' low. ' - ; vr V -'.' ,,"',;. ,.' .''.,.'.■ 

wsw = Walt Switch. Permitted are WMT-br NCWW^fV; I f 'NCMAif is 'selected, f*A.TlDQS 

will return from the RS-232-C routine whether the byte was 

recti ved/transmi tted or not. 

SETCOM<ENTER> wSi display the current RS-232-C settings. 

NOTE: MULTIDOS does not check for the presence of a RS-232-C serial board. 



SKIP Read a 40 track diskette In a 80 track drive. 

SKIP[ [:ld]<ENTER> 

d = drive number to read a 40 track diskette In a 80 track drive. 

The permitted drive numbers are 1, % and 3, If b used, al skips are removed. 

This command will allow you to READ a 40 track diskette in an 80 track drive. 

if no drive number, or 0, is specified, then al SKIP'S are removed. 

NOTE: Whenever the system diskette is reconfigured with CONFIG, al skips are removed. To determine if 
SKIP is present, use CONFIG (?)<ENTER>. 

TIME Sets time. 

[1) TIME hh:mm:ss<ENTER> 
{2) TIME<ENTER> 

Use syntax (1) to set the current time in RAM. 
hh = hour, mm = minute, ss = second. 

Use syntax (2) to cSsplay, in hh:mm:ss formal on a one time basis, the time currently stored In RAM 
(MOD Ml only). A non-powerup REBOOT wfl retain the time previously set in RAM. The hexadecimal 
locations 4041H to 4043H - MODEL I, 4217H to 4219H - MODEL EM store the current time, ii ss, mm, hh. 

TOPMEM Sets upper MULTIDOS system memory. 

(1) TOPMEM ddddd<ENTER> 

{2} TOPMEM rtinw»<ENTER> or TOPMEM nnnnH<ENTER> 

(3) TOPMEM<ENTER> 

ddddd = A decimal number from 28671 to 65535. 
nnnn = A hexadecimal number from 6FFF to FFFF. 

The above command sets the upper imlt of user free memory aval able to die operating system. It b 
useful if you have some hfeh memory drivers which you want to protect. MULTIDOS programs, such as 
SUPERBASIC, and others check the vakie of TOPMEM and operate at that imlt. The value is placed in 
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RAM it locations 4049H A 404AH - MODEL I, or 4411H & 4412H - MODEL ML The default vakie is the 
top of system RAM. When version (3) is entered, MLLTIDOS wBt dbpUv the highest usable byte currently 
avalable for MULTIDOSi MULTIDOS utlltles, and SUPERBASIC usage. 



VERIFY Reread at written sector. 
VERIFY switch<ENTER> 

This command wilt cause al disk writes to be reread for parity. AB directory writes and logical writes are 
verified. 

These are the characters obtained when the keyboard graphics driver is on. 

C3r~ stpl-i ± «=s 

(pixels lit) 

O » ■ !»■ 2«" 3 *= ■ 4 = 1 5 « ^ 6 = r 

7 = , 8 = % 9=1 A ~ * B = m C = fc D«J 

E = ■ F = 6 = ■ H« # » I= r Jis l K "| 

L = f M = |» N = ^ ° = > P = J 

S = |. T = f U = p V= b 

Z = ■ up-arrow « ^ 

lowercase (or SHIFTED without lowercase keyboard) 

* = < b = S c= l d = * e= l f= 1 Q = * 

h = ^ i = ^ j = i k = - i= l • = « n = ; 

o = fc p = L q = ^ r = J « - j t = J u = J 

v-3 w- B x = fc y»J z=| 



Q = 



W = • X = ■ Y 



Page 30 



SYSTEM UTUT1ES 
BACKUP/CMD Duplicate a cfckette. / 

BACKUP[ A] [:][drv] [:l[drv]<ENTER> ; 

This utility will duplcate at ttes from one diskette to another. The 'A* option, If specified, causes an 
absolute FORMAT and does not check or warn the user if the destination dbkette contains data. Source and 
destination drive numbers may be specified In the entry. 

The source diskette is the diskette which contains the ties, and the destination diskette is the diskette which 
the files are to be duplicated on. The source diskette drive and destination dbkette drive may be the same 
drive number. If the source and destination drive are the same, BACKUP wil prompt you when to mount 
the source or destination diskette (swapping). To prevent re-writing on the source diskette when swapping g 
required, place a write-protect tab over the write protect notch of the source diskette. BACKUP does not 
verify at the fBe transfer stage unless •VERIFY' Is active. 

NOTE: BACKUP wHI not backup a NEWDOS/80 Model III diskette. 

The BACKUP utility is menu driven and wBI take you through the easy procedure to duplicate a diskette. 

BACKUP<ENTER> or CMD "BACKUP "<ENTER> from SUPERBASIC 
the screen will clear and 

•MULTIDOS Disk Duplicator Program - Version X.X 
Ql Which drive contains the sourct dbkette? ' 

wll appear. The program b awaiting a numerical response of to 3, or 0> to 3' folowed by <ENTER>. If 
the source drive number was specified in the command entry, the question w*l automaticaBy be bypassed. 

Respond with the drive number which wil contain the source dbkette. tf the response was 0, 1, 2, or 3 

then: 

Q2 'Which drive for the destination dbkette? .* 

wBI appear. Again the program b awaiting a numerical response of to 3, or 0- to 3' folowed by 
<ENTER>. If the destination drive was specified in the command entry, then thb question w91 be bypassed. 

Respond with the drive number which wil contain the destination dbkette. If the response was 0, 1, % or 3 
then: 

Q3 Tress "ENTER" when the source dbkette b in drive X.' 

wil appear. Whereas X b the response to the first query (Q1). Mount the source dbkette into drive X, tf 
it b not already there, then <ENTER>. 
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MULTIDOS will analyze the source diskette for trade count and density, then display: 

'The source diskette has YY tracks, in ZZZZZZ density. 

Q4 Track count for the destination diskette { 35 to 96 )? ' 

Where "YY" b the number of tracks on the source diskette and "ZZZZZZ* Is the density of the source 

diskette. The destination diskette will be formatted in "ZZZZZZ" density; however, you may specify the 

track count for the destination diskette. If a null, just "ENTER", is pressed for the track count, BACKUP 
will use tr YY n for the track count. ; 

If the entered track count is insufficient to copy al fies, BACKUP waT dsplay: 

'Insufficient track number to copy al fies! 1 

then revert to the third query (Q3). 

If the track count response b acceptable, BACKUP w8l display: 

'Press "ENTER" when the destination diskette is in drive W.' 

where "W* b the response to the second query (Q2). If the destination drive b the same as the source 
drive, you MUST swap the diskettes. If the destination dbkette was previously formatted and the 'A' option 
was not specified In the BACKUP command then the message: 

■Dbkette previously formatted. 

Q5 Do you want to re-format this diskette? ' 

wit appear. If you want to abort BACKUP, press <BREAK>, If you want to re-format thb diskette, enter 
"Y", if you want BACKUP without formatting, <ENTER>. 

The above message and query wll not appear if the 'A ( option was specified as part of the BACKUP 
command. If thus b the case then a {re}-format of the destination dbkette wll take place using the source 
diskette density. 

BACKUP does not check the destination dbkette for a density match with the source diskette. If the 
destination diskette had been formatted with a different density, you MUST respond "Y" to the fifth query 
(Q5). 

The destination dbkette wll be formatted if no address marks are found or a "Y 1 response was entered 
for the fifth query (Q5). The formatting wil proceed then BACKUP wil verify the destination dbkette. 
BACKUP does not alow any flaws on a destination diskette. 

If the source drive and destination drive are the same, BACKUP wit ask you to insert the source diskette 
and destination dbkettes as required. The swapping w8t continue as necessary until al the flies are copied 
onto the destination dbkette. 
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After BACKUP has copied al fies: 

^Completed 
Press "ENTER" when a MULTIDOS system diskette b in drive zero. 1 or 'Insert SYSTEM <ENTER>' 

wSI be displayed if either the source or destination diskette was In drive 0. This prompts you to insert a 
MULTIDOS diskette to return to the state prior to entering BACKUP. 

You may change the format pattern bytes which BACKUP/CMD generates. The system diskette should be in 
drive a To do so use the ZAP utility and specify Display File Sectors from the ZAP menu. When the 
relative fie sector prompt appears just press <ENTER> and relative file sector of BACKUP/CMD wBI be 
displayed. You may change the format byt« to a different pattern. The format pattern bytes are located 
at relative bytes 8E hex and 8F hex, of this sector, for double density pattern. The format pattern bytes 
for single density are located at 9E hex and 9F hex of this sector. For further detals on the use of 
ZAP/CMD see the description towards the end of this section of the manual. 



Display of relative sector of BACKUP/CMD using ZAP utility. 



B 
A 
C 
K 
U 
P 

/ 
C 
M 
D 



HEX00 
10 



DR 


TR 
03 

03 

SE 
05 
05 



F 1LE 
0000 
OOOH 



20 
30 
40 
50 
60 
70 
80 
90 
AO 
BO 
CO 
DO 
EO 
FO 



0F7A 
2A20 
2A20 
2A20 
2A20 
2A20 
2A20 
2A2A 
4442 
534E 
5072 
656E 
7468 
7474 
002E 
6F6E 



4261 
2020 
2028 
436F 
2045 
436F 
2020 
2A2A 
4C20 
4720 
6573 
2003 
6520 
6520 
0374 
2064 



636B 
204E 
6329 
736D 
6C65 
7270 
204E 
2A2A 
4445 
4445 
7320 
0A43 
736F 
6973 
6865 
6973 



7570 
4F54 

2020 
6F70 
6374 
6F72 
4F54 
2A2A 
4E53 
4E53 
2245 
6F6D 
7572 
2069 
2064 
6B65 



2020 
4943 
2031 
6F6C 
726F 
6174 
4943 
2A2A 
4954 
4954 
4E54 
706C 
6365 
6E20 
6573 
7474 



2030 
4520 
3938 
6974 
6E69 
696F 
4520 
2A2A 
5920 
5920 
4552 
6574 
2064 
6472 
7469 
6520 



3938 
2020 
3220 
616E 
6373 
6E2E 
2020 
0182 
3D20 
3D20 
2220 
6564 
6973 
6976 
6E61 
6973 



327E 
202A 
202A 
202A 
202A 
202A 
202A 
004D 



6DB6 
E5E5 



7768 
2E0D 
6B65 
6520 
7469 
2069 



.zBackup 0982 

NOTICE 

(c) 1982 

Cosmo po 1 i tan 

Electronics 

Co r po r a t ion. 

NOTICE 

*»*•*******• M 

DBL DENSITY = m. 
SNG DENSITY = .. 
Press "ENTER" wh 
en . .Comp I e t e d . . 
the source d I s k e 
tte is in drive 
...the destinati 
on diskette is i 



CAT/CMD Obtain a tfirectory of a TRS-80 (tm) (fiskette. 

CAT* [:][d] [(M[,(][,S])]<ENTER> 

M = wait for "afen" dbkette mount in drb/t 0. 
1 = incLde invisible fles. 
S = Incbde system fies. 

This utlity wfll put] a directory on practicaly any MODEL I or MODEL Ml diskette, regardless of the 
address marks, density, or sector/granule format. 
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CONVERT/CMD Change address marks on single density diskettes. {MODEL HI only) 

CONVERT [:][drv] 

Thb Model III utility will change the address marks on an *aBen" system formatted single density diskette, 
in order for MULTIDOS to read this diskette, the address marks must be changed. To accomplish this, 
simply enter the drive number of the target diskette after CONVERT. 

EXAMPLE: 

CONVERT :2 

Wil change the address marks on the diskette In drive 2. 

If no drive number or zero Is specified you wBI be prompted to Insert the target diskette in drive zero. 
After the process b completed or an error occurs, you wHI be prompted to Insert a MULTIDOS system 
diskette. 

COPV/CMD Duplicate a single fie. 

Thb utility wfl) copy a fie from one diskette to another. The diskette which contains the fie wll be 
referred to as the source diskette. The diskette in which the fie wBI be placed on wll be referred to as 
the destination diskette. The source and destination dfekettes may be: 

1. The same diskette. 

Z Diskettes to be mounted In the same drive, 
or 3. Diskettes In two different drives. 

This utility requires AIL drhespecs. if the flespec for the destination diskette is the same as the fiespec 
for the source diskette then the flespec need not be repeated. 

(1) COPY CHARGES/TXT:1 TO :2<ENTER> 

If the destination diskette's drivespec b the same as the source diskette's drive spec, you wll be prompted 
to mount the source or destination diskette (swapping). 

(2) COPY :3 SHIFT/TXT TO MURK/ABC<ENTER> 

(3) COPY SHIFT/TXT^ TO MURK/ABC:3<ENTER> 

Both of the above two command entries wll duplicate the contents of SH1FT/TXT Into MURK/ABC on drive 
number three. 

System diskettes are MULTIDOS system dfekettes with at least, DOSO, DOS1, DOS2, DOS3, and DOS4. ABen 
dfekettes are cSskettes with a system other than MULTIDOS Datt diskettes are diskettes without a system. 

Whenever drive zero b specified and the source or destination diskette b not a system cSskette, a ■$« 
MUST precede the source fiespec. 

(4) COPY $WHENEVER/BAS:0 TO :2 

(5) COPY :0 $HELPME/CIM TO SHOWME/CIM 

(6) COPY $ THEM/CLD:0 TO T>CM/NEW:1 

(7) COPY $ MANUAL/TXT:3 TO :0 
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The "$» designator En COPY wBi permit you to copy fiespecs from an al en/ system/data diskette to any 
other aBen/system/data diskette. However, multiple swapping will be required to bring In the correct system 
overlays Please foDow the prompting provided by COPY. Whenever the prompt: 

'Press "ENTER" when a MULT1DOS system diskette !s In drive zero.' or 'Insert SYSTEM <ENTER>' 

appears, remove the source or destination diskette and insert your MULTIDOS system diskette, then press 

"ENTER". 

COPY will carry over the source ftespec's date. However, if you want the destination fiespec to have the 
current RAM date, place a *§ a immediately In front of the source fiespec 

(8) COPY #CHECK1NG/BAS:1 TO CHECKlNG/BAS:2 

(9) COPY #CHECKING/BAS:0 TO :0 

(10) COPY :2 £CHECKING/BAS 

(11) COPY :2 £XECK1NG/BAS TO CHECK1NG/BAS 

(12) COPY :0 $ #^HECK1NG/BAS 

TECHNICAL NOTES ON COPY 

COPY w8I execute In the following sequence. 

1. Check for «$«. 

2. Check for f. 

3. Position the source fiespec in COPY'S DCB-1. 

4. Insert source drivespec into DCB-1 then check for vaidity. 

5. Position the destination fiespec in COPY 1 * DCB-2. 

6. Insert destination drivespec into DCB-2 then check for vaidity. 

7. Check for swap. 

8. OPEN source fiespec. 

9. Store source fiespec sector alocation. 

10. READ In as much of source fiespec into aval able RAM. 

11. Check for swap. 

12. Attempt to OPEN the destination fiespec, rf found store current sector alocation. 

13. Calculate and store the amount of free sectors on the destination drive, (convert granules) 

14. If the destination fiespec exists, add and store the total number of sectors avalable. 

15. Compare the total sectors avalable on the destination drive with the source flespec's sector alocation. 

16. Abort COPY if insufficient space rs on destination diskette. 

17. If the destination fiespec doesn't exist INIT the destination fiespec 

18. Check for "SYSTEM" swap. 

19. Allocate al sectors (via granule alocation) on the destination diskette. 

20. WRITE out to the destination fiespec as much of the source fiespec read Into RAM in step 10. 

21. Check for swap if al of source fiespec was read into RAM and written out to the destination fiespec 

22. Check for "SYSTEM" swap. 

23. Check for swap. 

24. Close destination fiespec 

25. Check for "SYSTEM" SWAP. 

26. Display error if any. 

27. Return to MULTIDOS or SUPERBASIC. 
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tf an error occtirj during steps 4, 6, 8, 10/16, t7, 20, or 24> then COPY wHI jump to step 25. 

For those users who have operated other COPY utilities, please appreciate that COPY assumes al 
nonconfltcting drivespec diskettes are mounted prior to executing ffe duplication. 

EXAMPLE: (13) COPY FlM.OVER/TXT:2 TO :3 

Does NOT prompt the user to mount any diskettes. 

NOTE: If the drivespec Is not part of a fSespec the colon, ":*, Is optional. 

EXAMPLE: COPY FILEDOS:! TO :2 
or COPY FILEDOS:1 TO 2 
or COPY FILEDOS:l :2 
or COPY FILEDOS:l 2 

DDT/CMD Disk drive timer, 

DDT<ENTER> 

DDT/CMD is a disk drive diskette rotation speed timer. The utility wBl ask for the drive that is to 
be timed. At that point you may press <BREAK> to exit the utility. Enter the number of the disk 
drive. A diskette, formatted or un-formatted, must be in the selected disk drive. An instantaneous 
speed will be displayed as wel as a smoothed speed. The diskette rotation speed should read 300 
revolutions per minute (RPM) plus or minus 1 percent (297 RPM to 303 RPM). To restart the utility 
use the left-arrow key. 

NOTE: DDT does an OUT 254,0 to set to 1.77 MHz (Model I), or OUT 95,0 to set to 2.02752 MHz 
(Model III), most high speed modification clocks. 



FORMAT/CMD Prepare a diskette for data storage. 
FORMAT! [:]d] [Al<ENTER> 

This utility wBI prepare a diskette that wBl not contain the MULT1DOS operating system, which wHI 
leave the maximum disk space for your fles. These diskettes are referred to as "DATA" diskettes. 

'd 1 = drive number and is optional. 
A = absolute FORMAT - does not check or warn user tf the target diskette contains date. 

Operation Is as folovs: 

■MULTiDOS Formatter Program - Model 1(11) - Version X.X 

Which drive contains the diskette to be formatted? * 

Reply with O, 1, 2. or 3 for sideO, and 0% V, 2«, or 3' for sWel of two-sided drives. No query if 
drive number was specified in FORMAT command. 
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'Name of diskette to be formatted? ■ 

Reply with the desired diskette name "(DATA!, BASICPRO, Phone § t etc.). The name may be 1 - 8 
characters !n length. FORMAT will default to * DATA *. 

Track count for this diskette ( 2 to 96 )? ■ 

Reply with the desired track count. FORMAT can only format up to the drive capaaclty. If you only have 
40 track drives, you cannot format 80 tracks, if you do not enter a track number, FORMAT will default 
to 40 tracks. 

•Date for diskette to be formatted? ' 

Reply with a date in the format mm/dd/yy. FORMAT will default to the current RAM date. 

The master PASSWORD for this diskette. 

Reply with the password desired for this diskette. The password may be 1 - 8 characters in length, 
FORMAT wBI default to "PASSWORD". 

•Single, Double, or "P" density ( S>D, or P )? ' 

Reply with S, D, or P. 

WII default to current system configuration. 

•Which track for the directory ( 1 to XX )? ' 

XX = One less than track count. 
Default is to track 17 decimal {11 hex). 

If the diskette to be formatted contains data, MULTIDOS wBI suspend formatting. Only a "Y" response wDI 
cause formatting to continue. This k not the case if the 'A' option was specified as part of the 
FORMAT command. 

Formatting wll proceed. You wll be kept advised of the progress via screen messages. MUTIDOS wil lock 
out granules (if the diskette has flaws) and bump the verifying counters to the next granule. 

You may change the format pattern bytes and/or the default track count in FORMAT/CMD. The system 
dkkette should be in drive a To do so use the ZAP utiity and specify Display Fie Sectors from the ZAP 
menu. When the relative fie sector prompt appears Just press <ENTER> and relative fie sector of 
FORMAT/CMD wil be dkptayed. You may change the format bytes to a different pattern. The format 
pattern bytes are located at relative bytes 8E hex and 8F hex, of this sector, for dai>te density pattern. 
The format pattern bytes for single density ire located at 9E hex and 9F hex of this sector. The default 
track count b in hexadecimal. The default format track value is located at relative byte AF hex of this 
sector. For further detals on the use of ZAP/CMD see the description towards the end of this section of 
the manual 
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Display of relative sector of FORMAT/CMD using ZAP utility. 
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GR/CMD Configure keyboard for graphics 

GR<ENTER> 

GR/CMD fs the MODEL I method of producing graphics from the keyboard. It loads into high memory and 
resets the TOPMEM address. A pseudo-version of this utility is loaded automaticaly, at reboot/power-up, if 
the KEYBRD function <G' b enabled. (Refer to - LIBRARY COMMANDS; KEYBRD). 

To produce keyboard graphics press <SHIFT><LEAR>. To return to normal keyboard characters press 
<SH1FT><CLEAR> again. Refer to the keyboard graphics chart at end of the LIBRARY COMMANDS section 
of this manual for graphic key descriptions. 



MEM/CMD 



Machine memory test 



MEM<ENTER> 



MEM is a RAM memory test utaity. It wil test random access memory from 40OGH to TOPMEM. If a test 
byte fais h wBl be indicated on the video along with the bit number and the utility w3l exit. 



RS/CMD 



Machine Memory Scanner. 
RS<ENTER> 



This utility can scan the memory from OOOOH to FFFFH and attempt to locate an 8 bit byte or 16 bit 
word specified by the user. The utility wBl ask: 

•START? 
Enter the starting address, in hex, at this time. Next the utility wBl ask: 
•STOP 7 
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Enter the ending address, in hex. Next the utiity wfll ask: 

■BYTE, OR WORD SEARCH (B/W)7 

For a one byte, search enter "B*. For a two byte search, enter "W". Next the utility will ask you to 

enter the search target* Enter the target at this time. The input must consist of two or four hexadecimal 

characters, without the "H" suffix, and must not contain any Hanks. Acceptable words would be n 00AB tt , 
"DEW, etc. Acceptable bytes would be "74", "09", etc. 

Next, for word scans only, the utility wBl ask: 

'Enter auxilary mnemonic ' 

You can optionally inquire about calls, jumps, and loads to a selected word at this time. 

Enter one or more of the following characters and the <ENTER> character; 

C = CALL/CARRY 

J = JUMP 

L = LOAD 

M = SIGN MINUS 

N = NON 

P = SIGN POSITIVE 

PE = PARITY EVEN 

PO = PARITY COD 

Z = ZERO 

The above terms may be combined if needed. If no auxiliary mnemonic k desired press <ENTER>. For the 
I. 1 (-OAD) command, the fofiowing question wBI be asked: 

'IMMEDIATE "I", I OR DIRECT *D°7 
If the response h "D", the utility wfll ask: 

"F" FROM or "T" TO the register? 
Answer as desired. Finaly the utility will ask: 

•Accumiiator, A or register pair - BC, DE, HL, SP, IX, IY :' 
Enter the desired register pair. 
The utility w8l then display the hexadecimal locations where the specified byte or word is found. 
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EXAMPLES: let START = 0000, STOP = 2FFF {ROM} 

(1) Enter search word 3C00<ENTER> 
Enter auxi I fary mnemonic <ENTER> 
04C1 0555 06F2 2080 

Function completed - Press "R" to scin again, 
"CLEAR" to return. 

The word 3C00 was referenced in ROM at locations 
04C1H, 0555H, 06F2H, and 2080H. 

(2) Enter search word 4000<ENTER> 
Enter auxiliary mnemonic J<ENTER> 
0005 0008 

Function completed - Press "R" to scan again, 
"CLEAR" to return. 

The "JP 4000H" command is found at locations 
0005H and 0008H In ROM. 



SPOCL/CMD 

This MULTIDOS utility b designed to aBow the computer to function at almost full speed without delays for 
the printer to function. The utflity provides a variable RAM buffer for paralel printers. 

SPOOL<ENTER> 
The foBowing questions wSI appear. Respond as indicated. 

(1) How many 256 byte blocks for spooSng (1^99)* ' 

This lets you set the buffer size for the spooler. The size b selected in 1/4 K increments. For 
example, to reserve a 2K buffer the reply to the above question would be 8<ENTER>. 

(2) "ENTER memory size (DECIMAL) YOU WANT TO PROTECT. ' 

Use thb to protect a hfeh memory routine which does not protect itself by setting TOPMEM (4049H 
- MODEL I, 4411h - MODEL III). Press <ENTER> to use the value MULTIDOS has establshed in 
TOPMEM. <BREAK> to abort spooler. 

The spooler wHI now commence operation and control of any printed output. 

To suspend output, press <R1GHT-SHIFT>^CBREAK>. You wfB be asked if the buffer b to be saved. A "Y" 
response wll save the buffer contents, and a "N" response wil reset the pointers and send a carriage 
return character to the printer. 
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The next query to appear will be: 

•SPOOL* ■ 

Enter "Y" if you want to continue SPOOUng. An "N" response wll unifcik Ihe SPOOLER from the printer 
DCB and restore TOPMEM If possible. 



TAPE/CMD Tape to disk transfer utility 

TAPE<ENTER> 

This utility aBows you to transfer 500 baud system programs from tape onto diskette. The utility wll 
prompt: 

ENTER T" to read TAPE, or "D" to return to DOS? 

Ready the tape deck and position tape to start of He, Enter <T> to begin loading the system tape. 

If the fie on tape does not load property or Is not contiguous an error message wll appear and the tape 
load wHI exit. 

If the fie loads properly then ft is ready to be transferred to diskette. 

The START, END and ENTRY points of the program wttl be displayed. 

NOTE: The following prompts refer to the disk fie to be created. 

You wilt be asked if the Just-loaded program from tape, is to be modified. If so respond <Y>, tf not then 
respond <N>. 

If <Y> b entered then you wll be prompted: 

Are Interrupt to be enabled or disabled (E or D)Z 

Enter <E> If the Interrupts are to be enabled before the program executes. Enter <D> If the interrupts 
are to be disabled before the program executes. 

Enter new base address In hEX ? 

Enter a new base address for the program to load at. Thfa enables the program to be loaded from disk to 
a non-conflicting area with DOS. The suggested base address should be greater than 5300 hex. An appendage 
wll be added to the dhk fie such that the program wll be transfered to its proper operating location 
after It fa loaded from disk. 

A third prompt wll appear: 

Inhialze LEVEL II type DCB A RESTART vectors (Y OR N) ? 

Respond <Y> If the program Is to operate ki a LEVEL II environment This wll alow programs that 
normaly operate in a LEVEL II to be executed properly after loading from disk. This fa done by adding an 
appendage to the disk fie which creates the LEVEL II environment before any program execution. Respond 
<N> if the program fa not to operate fri a LEVEL II environment. 
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Whether the program is to be modified or not the following prompt wfll appear: 
Is a new flespec required (Y or N) ? 

Enter <Y> if a new flespec is required. If <N> Is "entered the name of the He loaded from tape wBl be 
used and the extention /CMD wBl be appended to the' flename. 

Filename please? 
will appear if you choose to gve the program a new fiespec 
Once aS prompts are answered the program will be transferred to diskette. 
NOTE: Some machine language programs may not execute properly after transferlng to tfiskette. 
EXAMPLE: 

ENTER "T" to read TAPE, or "D" to return to DOS7 
<T> is entered and the system tape loads. After loading the START, END and ENTRY points are displayed. 

Is the PROGRAM "SAMPLE" to be modified {Y or N)? 

Y is entered. 

Are interrupts to be enabled or disabled (E or D)? 
D is entered. 

Enter new base address in HEX? 
7000 is entered. 

Inttiaize LEVEL II type DCB & RESTART vectors (Y or N) I 

Y is entered. 

is a new F1LESPEC required (Y or N) 

Y b entered. 

Flename please? 
SPLATT/CMD:1 is entered. 

The fie is transferred to dUkette on drive 1. When the program, SPLATT/CMD, b called up from diskette, 
it w2l be loaded beginning at 7000 hex, the interrupts w8l be dsabled, the LEVEL II environment wll be 
inrtiaSzed, and the program w3l be transferred to Its proper operating location and begin to execute. 
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VFU/CMD - , 

/" This versatile file utlity (VFU) provides for five frequently needed dkk operations: moving of fles from one 

\ diskette to another, multiple fie copying, purgng of fles, printing a disk directory, and menu based 

execution of aB programs on a disk. VFU wBl prompt theuser if a system diskette is required in drive 

for proper operation of VFU. 

INITIALIZATION & EXIT 

To initiafize the utility from MULTIDOS, use the folowlng Instruction: VFU<ENTER> 

To Inttialie the utility from SUPERBASIC, use the foBowtng Instruction; CMD"VFU"<ENTER> 

VFU/CMD wBl alow you to remove your MULTIDOS system diskette from drive zero to aBow you to copy 
or move between 2 diskettes, using a 2 drive system, or purge a diskette using a 1 drive system, provided 
a warning message does not appear. 

When Mtialzed, the utility wll clear the screen and prompt with the foBowing message: 

Versatle FBe Utlity - Version X.X 

(c) 1982 Cosmopoltan Electronics Corporation. 

Press Action 

"C 1 Copy 

■E" Execute 

■H" Hard Copy 

■M 1 Move 

■P 1 Purge 
Choice 

A rapkfiy winking cursor wll indicate that user Input b required. 

^ To exit the utlity, when the wlrfctng cursor Is dfeptayed, press <CLEAR>. If you entered the utlity from 
SUPERBASIC via the "CMD^FU" mode, you wil be returned to SUPER8ASIC If you entered the utlity 
from MULTIDOS, you wll be returned to the DOS ready mode. 

VFU COPY COMMAND 

To copy files from one drive to another, use the "C* command. The utility wil then prompt 

Press "S" for SELECTIVE, or T 1 for TOTAL. 

To select the fles to be copied, press "S". To copy the entire diskette, press H" 1 . Then the utlity wll ask; 

Include ■INVISIEUE" fles! 
Include "SYSTEM 1 fles? 

Answer *Y" or ■N" as appropriate. 
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Flnaly, the utility will request the source and destination drives with the folowing prompt: 

Source drive? Destination drive? ;'■''■ v-v ^ ' /; 

NOTE: The source and destination drive cannot be Identical. : If this situation occurs you wBl be 
re-prompted for the source and destination drives. 

If the selective option was chosen, the directory wBl be displayed with the winking cursor next to 
the first fie name. If that fie is to be copied, press *Y". A *+* wfll appear In front of the fie 
name to indicate that It Is to be copied and the winking cursor wll move to the next fie. If you 
do not want to copy the fie, press "N", space bar or right arrow. The cursor wll move to the next 
file. The four arrow keys may be used to move the cursor. 

During the fBe selection process, the left arrow wfll reposition the cursor to the previous fiename. 
The shifted left arrow will reposition the cursor to the first fiename. To remove a *+■ position the 
cursor over the plus and press <N>. 

If the T" option was selected, the V" sfen will appear In front of al flenames. 

After marking the ffles to be copied, the folowlng prompt wll appear: 

Press "A' TO ABORT, "ENTER" TO EXECUTE, or "R" TO REPEAT. 

Press <ENTER> to start the copying function. If you do not want to copy, press "A". To 
prematurely terminate the copying function, hold down a shift key. The utility wll complete copying 
the current fie and terminate before It starts to copy the next fie. 

If a 'Disk space full' error occurs during the transfer of a fie then the fie is not a complete fie. 
The flespec should be immediately purged from the destination diskette. 

NOTE: VFU's copy command can also be used as a transfer utility to copy fles from TRSDOS (tm) 
Model III double density diskettes. The minimum configuration required is 2 drives. This wll alow 
you to copy TRSDOS VI. 3 fles to a non-TRSDOS diskette In another drive. 

VFU MOVE COMMAND ' 

This command performs the same as VFU's COPY command except the file on the source drive wll 
be purged after the copy is completed. 

VFU EXECUTE COMMAND 

To execute programs from a diskette, use the V command. The utility' wll then display the drive, 
diskette name and date, the free space and an alphabetical directory. Use the arrow keys to position 
the winking cursor in front of the file to be executed and press *YV 

If the selected flespec has the "/CMD* extension, VFU wtl load and then execute that flespec. If 
the »/CMD" extension is not present, VFU wll load BASIC and then load and attempt to run the 
flespec. 
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VFU PURGE COMMAND 

To purge fles from a diskette, use the "P» command. The utility will then prompt: 

Press "S" FOR SELECTIVE, or "T" FOR TOTAL 

To select the files to be purged, press »S". To purge al fles from the diskette, press "T". Next the utility 
wii ask if Invisible and system fles are to be considered for purge action with the following prompts: 

include "INVISIBLE" fBes7 
Include "SYSTEM" fles? 

Answer *Y" or "N" as appropriate. 

Finally, the utility will request the drive number with the 'folowing prompt: 

Drive number? _> 

If the selective option was chosen, the Directory from the selected drive wll be displayed with the winkkig 
cursor next to the first fie name. If that fie Is to be purged, press "Y". A ■+* will appear m front of 
the fie name to indicate that It Is to be purged and the winking cursor wll move to the next fie. If you 
do not want to purge the fie, press "N", space bar or right arrow. The cursor wll move to the next fl«. 

During the fie selection process, the left arrow wll reposition the cursor to the previous filename. The 
shifted left arrow wll reposition the cursor to the first filename. To remove a ■+■ position the cursor 
over the ■+■ and press <N>. 

If the ■T l option was selected, the ■+■ sign wll appear fat front of al filenames. 

After marking the fles to be purged, the folowing prompt wll appear: 

Press "A" TO ABORT, "ENTER" TO EXECUTE, or "R" TO REPEAT. 

Press <ENTER> to start the purge function. If you do not want to purge, press «A*. To prematurely 
terminate the purge function, hokt down a shift key. The utility wll complete purging the current fl« and 
terminate without purging any additional ties. 

After the purge process Is completed, the revised directory of the diskette wll be displayed, 
VFU PRINT DIRECTORY COMMAND 

To print a dbkette directory, use the W command. To exit the utility when the normal cursor Is 
displayed, press <BREAK>. The utlity will ask if invisible and system files are to be IncWed In the 
directory printout and which drive is to be used. Then ft w«l a* for the name or number of the diskette 
(8 characters maximum). The directory wll be dfaplayed on the screen. Finaly, the utility wll prompt with 
the folowing message: 

Press "A" TO ABORT, OR "ENTER" TO EXECUTE. 

A reply of <ENTER> wll cause the directory to be printed. If a 10 character/inch printer Is used, the 
printout width wll be sized to fit inside a dskette jacket. 
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ZAP/CMD Disk sector/memory modify utility 

2AP<ENTER> ■''■."•"'■■;. 

ZAP/CMD, tw ZAP, is a quick, simple way to read and write diskette sectors, tie sectors, memory and fix 
disk directories. 

I - MODES OF ZAPPING 

A. DISKETTE SECTORS 

This faction is the default for ZAP. It wil properly step through a single density, double density, or »P« 
density diskette provided the target drskette has Its respective configure byte iqxiated (only possible If a 
"DIR" was performed). There is no configuration for properly stepping through a TRSDOS (tm) MODH. Ill 
diskette (sector numbers 1-18 vs 0-17). 35 b the defaiit track number when a step is executed that would 
decrease the track number below a Use of this function requires user dfec|pline In selecting the track 
number. ZAP uninhlbitly alows track and sector numbers from 0-255. 

B. FILE SECTORS 

The primary function of ZAP is to access files, regardless of protection, regardless of density, regardless of 
the operating system. However, the flespec. must be in the directory. 

ZAP has the abiity to display and motffy fie sectors on the following operating systems: 

MODEL I MODEL III 
TRSDOS 2.0 to 2.3 TRSDOS 
NEWDOS/21 LDOS 

ULTRADOS DOSPLUS 

VTOS a I I JsEWDOS/80 

DOSPLUS a I 1 
LDOS lit. 
NEWDOS/80 all 

NOTE: As of thb writing TRSDOS 2.7, Model I double density, is not supported. 
NOTE: TRSDOS MODEL III does not have their system fles In the directory. 

In addition, ZAP requires the fiename to be entered In the case which the fie wil be In the directory. 
Thk may seem strange to some, but there are ways to enter a lower case He name! (Usualy upper 
case). Although ZAP wil search al drives for a given flespec, Jt is suggested that the drive number be 
appended to the filename. Le. FIENAME/EXT:D. This wil greatly speed t*> the purpose at hand, because 
ZAP performs an analysis on each dskette prior to tile HIT search for the fiespec's hash code. 

To dkptay fie sectors enter the appropriate filename. You wSI be prompted for the relative sector in the 
fBe to tfcpiay. Defaiit is the first sector of the fie. A request for dbpiay of a sector that is out of range 
f£splays the last sector. 

C. MEMORY ,- .-•-,■ 
Memory can be addressed in one byte increments. 
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II - USER !WUT 

A. VALUE KEYS- .--;.'? f :■ '.■.;:•.-■■■■:■"■;■'■ 

Drive numbers are always entered in decimal form. Track numbers, sector numbers ffl * sectors and 
memory addresses are Interpreted as decimal, unless "H" - hexadecimal notation - Is appended to the 

number. 

B. BREAK KEY . 

Pressing the "BREAK" key wBI return the user to the previous query. When the ZAP command prompt is 
displayed, pressing "BREAK" wfll exit the ZAP uffiity. 

NOTE: DRIVE, TRACK, and SECTOR are considered the same query. 



HI. DISPLAY MODES AND MOVEMENT 



A. Diskette sectors 
Key pressed 



up arrow 

down arrow 

right arrow 

shift right arrow 

left arrow 

shi ft left arrow 

■T" 

■S" 



Act ton 

increase track count by one 
decrease track count by one 
increase sector by one 
increase sector by one 
decrease sector by one 
decrease sector by one 
reselect track/sector 
resetect sector 



B. File sectors 
Key pressed 



up arrow 
down arrow 
right arrow 
shift right arrow 
left arrow 
shift left arrow 



■ : -' ■ Action 

increase file sector by one 

decrease file sector by one 

increase file sector by one 

increase file sector by one 

decrease file sector by one 

decrease file sector by one 



C. Memory 

Key pressed 

up arrow 
down arrow 
r ight arrow 
shift right arrow 
left arrow 
shift left arrow 



Action 

increase address by 256/100H 
decrease address by 256/100H 
increase address one 
in.crease address by 16/IOH 
decrease address one 
decrease address by 16/10H 
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IV. MODIFICATION AND UPDATE 

A. -Pressing "M* after a displayed 256 bytes of a MEMORY page or a diskette SECTOR, wilf place the user 
in the modification mode. This will be noted by the dual binklng cursors - one in the HEX area and the 
other In" the correspond™! ASCII area. 

B. The four arrow keys wBI move the cursors in the direction of the arrows. 

C The "@ B key will toggle the user between HEX and ASCII modification mode. This is indicated by the 
presense of 9HEX' or 'ASC' in the upper left hand corner whie displaying a sector. 

D. MEMORY modification b effective immediately. SECTOR modification are not effective unti the user 
presses "ENTER" to terminate modification, and ■ENTER* a second time to update the sector. 

FIX DIRECTORY COMMAND 

This command Is designed to fix the directory of MULT1DOS diskettes. The FIX DIRECTORY command of 
ZAP wBI repair the GAT sector for read errors and for erroneous granule allocation bytes for ffles. It wil 
not repair the GAT sector for erroneous granule alocation bytes for gramle lock-out. It wil fix the HIT 
sector for read errors and wil fix erroneous HIT bytes using directory fie sector information. It wM 
repair the directory ffle sectors for read errors but wil not repair erroneous directory fie sector entry 
information. 



Display of GAT (granual alocation table) sector using ZAP utlity. 



HEX OO FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF , .... 

10 FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFD 

20 FCFC FCFF FFFF FFFF FFFF FFFF FFFF FFFF 

DFtV 30 FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF , 

1 40 FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF - 

50 FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF 

60 FCFC FCFC FCFC FCFC FCFC FCFC FCFC FCFC . 

TRK 70 FCFC FCFC FCFC FCFC FCFC FCFC FCFC FCFC 

017 SO FCFC FCFF FFFF FFFF FFFF FFFF FFFF FFFF 

11H 90 FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF 

AO FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF 

SEC BO FFFF FFFF FFFF FFFF FFFF FFFF FFFF FFFF 

OOO CO 0303 0303 0542 FFOO OOBO BFOO 2323 E042 B.. .«.##. B 

OOH DO 4D73 6C74 6964 6F73 3039 2D32 352D 3832 Hultido*09-25-82 

EO 0D2O 2020 2020 2020 2020 2020 2020 2020 . 

RPT FO 2020 2020 2020 2020 2020 2020 2020 2020 



SYSTEM UTBJTiES 



Display of relative ffle sector 18 of DOS9/SY5 {single density) using ZAP. 



ASCOO 

10 

DR 20 

1 30 

40 

TR 50 

25 60 

19 70 

80 

SE 70 

03 AO 

03 BO 

CO 

FILE DO 

O018 EO 

012H FO 



3C53 
454C 
4649 
4259 
7D7B 
3C45 
7973 
6D62 
2866 
6420 
7265 
2072 
2074 
6F72 
2720 
6574 



5041 

4420 

4C45 

5445 

3B62 

4E54 

6963 

6572 

6972 

6973 

6061 

6563 

6F20 

205B 

6865 

632E 



4345 
646F 
5350 
3D79 
337D 
4552 
61 6C 
206F 
7374 
207A 
7469 
6F72 
3235 
2730 
7B2E 
203D 



3E20 
776E 
2028 
79 7D 
7B3B 
3EOA 
2072 
6620 
2072 
6572 
7665 
6420 
3520 
3027 
0A62 
2064 



01B2 
2E0D 
5245 
2920 
6234 
0A6E 
6563 
4649 
6563 
6F29 
2062 
226E 
6465 
2074 
312C 
6563 



0063 

5041 

433D 

6231 

7D7B 

6E20 

6F72 

4C45 

6F72 

0A79 

7974 

6E22 

6369 

6F20 

6232 

696D 



6973 
5443 
6E6E 
7B3B 
3B62 
3D20 
6420 
5350 
0182 
7920 
6520 
2E0A 
6D61 
5B27 
2C62 
616C 



2048 
4820 
2C7B 
6232 
357D 
7068 
6E75 
2E20 
8063 
3D20 
696E 
C530 
6C20 
4646 
332C 
2076 



<SPACE> 
ELD down 
FILESP ( 
BYTE=yy> 
}{;b3>{; 
< ENTER >. 
ysical r 
mber of 
(•first r 
d is zer 
relative 
record 
to 255 
or X'OO* 
' hex . . b 
etc. ■ d 



. ".cis H 
. . PATCH 
REC=nn, { 
) bl<;b2 
b4X;b5> 
_nn =* pb 
ecord nu 
FILESP. 
ecor. * c 
o) . yy = 

byte in 

"nn" 

decimal 

to X'FF 
I,b2,b3, 
BCimal v 



M22B6H 


3F45 


7874 


7261 


2069 


676E 


6F72 


6564 


M2296H 


CDOS 


1FB7 


2012 


237E 


23B6 


1E06 


CAA2 


M22A6H 


5E23 


56EB 


22DA 


40EB 


D7FE 


8820 


E3C3 


M22B6H 


liOO 


0OC4 


0D26 


22DF 


40CD 


3619 


C29D 


M22C6H 


22E8 


40D5 


7E23 


F5D5 


7E23 


B7FA 


EA22 


H22D6H 


09E3 


E5CD 


0B07 


E1CD 


CB09 


E1CD 


C209 


M22E6H 


OCOA 


1829 


2323 


2323 


4E23 


4623 


E35E 


M22F6H 


E569 


60CD 


D20B 


3AAF 


40FE 


04CA 


B207 


M2306H 


722B 


73E1 


D55E 


2356 


23E3 


CD39 


OAE1 


M2316H 


CDC2 


092B 


09EB 


22A2 


4069 


60C3 


1A1D 


M2326H 


ES40 


2ADF 


407E 


FE2C 


C21E 


1DD7 


CDB9 


M2336H 


282B 


1600 


DSOE 


01CD 


6319 


CD9F 


2422 


M2346H 


2AF3 


40C1 


7E16 


0OD6 


D438 


13FE 


0330 


M2356H 


0117 


AABA 


57DA 


9719 


22DB 


40D7 


18E9 


M2366H 


C2EC 


237E 


22D8 


40D6 


CDD8 


FE07 


D05F 


M2376H 


40D6 


03B3 


CASF 


2921 


9A18 


197B 


56BA 



ODOO ?Extra ignored.. 

1923 ...r .»-#£.-. »-# 

2D22 A #V."-3 -" 

19F9 fc-_3.6_.U-. 

cdbi -.a_^#.-" to #E.-*-i 

E5CD .....-•--•-■«-*• 

2356 . ..)###*N#F#- >V #V 

EBE1 .i"...:_p-..j; 

C190 r+s..~#V#..9... 

F922 ... (.-" pi* * 

22CF .S*.»* w ., V*- 

F340 (+ c..p* r .a 

OFFE *.»-**'. 8...0.. 

7AB7 .. tP-T- "- 8 --- z C 
3AAF ..tf*-.S _:-| 

DOCS 3. .^.B) !^..xVJ.. 



Display of memory page 2286H using ZAP utJity. 
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DBLFIX/CMD Fix boot sector on DBLDOS {tm) diskettes {Double density operating systems only) (MOD 

I only) 

DBLFIX [:]drfvespec 

This utility will modfy DBLDOS (tm) data and system diskettes so that they can be read and written to by 
MULTIDOS. It wBI not affect the proper operation of the diskette. To use this utility you must not have 
the write-protect notch covered on the diskette to be fixed. 

To use the utitity place the diskette to be fixed into a disk drive other than drive 0. Enter the word 
'DBLFIX' folowed by a space and the drive number of the target diskette. 

EXAMFUE: To fix a DBLDOS diskette in drive 1. 

DBLFIX ;1 
The colon U optional. Once the cfsketie has been modfied the message: 
•Modification completed 1 

wll appear. If a data tfiskette has been previously fixed the message: 
Previously modified DBLDOS data dfckette" 

wll appear. If a system diskette has been previously fixed the message: 
•Previously modified DBLDOS system diskette' 

wBI appear. If the target diskette b not a DBLDOS diskette the message: 
*That is not a DBLDOS dskette* 

wll appear: If the target dskette is not formatted the message: 
'Data record not found during read* 

wll be dfepiayed. If an improper drtvespee h used to specify the target diskette then the message: 
'Please specify drive number 1 
wll appear. 
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SUPERB ASIC 

BASIC High level language interpreter. 

SUPERBASIC (fie name BAS1C/CMD) is a MULT1D0S command fie which contains the code to 
enhance/control the ROM, and adds disk input/output capabilities to LEVEL II Basic. 

BAS1C[ ff[V]][,mm][,command]<ENTER> 

This command will load SUPERBASIC into your system, from the Multidos ready prompt. A space is 
mandatory after the word "BASIC" if any of the optional parameters are to be specified, 

ff - An optional number of fEe buffers to be opened by Basic (0-15) 

If you want to use RANDOM disk I/O (input/output), and a record length other than 256, then key-in a V 
immediately following the character(s) that specify the number of fie buffer(s). 

mm - An optional upper memory Emit which can reserve space for machine language subroutines. 

command = Any vaBd BASIC command. 
NOTE: The default values are 3 fBes and all memory to TOPMEM avaiable to SUPERBASIC 
This version of SUPERBASIC is shorter than any other DISK BASIC, leaving more room for your program. 

EXAMPLES: 

0) BAS!C<ENTER> 

SUPERBASIC will be loaded with 3 file buffers open and aB of RAM up to TOPMEM avaiable for 
use. 

(2) BASIC 4<ENTER> 

SUPERBASIC will be loaded with 4 fBe buffers open and al of RAM up to TOPMEM avaiable for 
use, 

(3) BASIC 2V,60000,RUN n PROG1/BAS"<ENTER> 

SUPERBASIC will be loaded with 2 file buffers open, RAM from 6COO0 up wil not be avaiable to 
SUPERBASIC The program "PROG1/BAS" wil be loaded by SUPERBASIC and RUN. With the V 
appended to the number of fie buffers [2VJ, user defined record lengths are permitted. However, 
normal sequential disk I/O is permitted if the V is specified or not. 

For each file buffer opened, SUPERBASIC will reserve 289 bytes, 33 for a DCB (device control block), and 
256 for the I/O buffer. If the V parameter fe specified, an additional 256 bytes are reserved- One will be 
used for n FIELD"ing and the other for disk I/O. 
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BASIC * Recover BASIC program. 

BASIC *<ENTER> 

Thb command assumes SUPERBASIC was previously loaded into your system, you now have the MULTIDOS 
prompt, and you want to return to SUPERBASIC with the previous program unchanged with variables intact. 

CAUTION: Because SUPERBASIC has expanded "CMD" functions, and makes additional memory space 
avaiable, you cannot go from SUPERBASIC to MULTIDOS, execute commands such as "DIR" and then use 
"BASIC *" to return. In such cases you should use the CMD^uuuuu" function from within SUPERBASIC. 

If the return to SUPERBASIC was successful, a 'Continue? ' prompt will appear. Enter 'Y 1 if you want the 
program to continue {even after re-boots), 

BASIC I Down load a BASIC program, 

BASIC l<ENTER> 

This unique command permits you to transfer a BASIC program which has been loaded via an aien 
operating system or SUPERBASIC, with at least 1 fBe buffer, to SUPERBASIC, without saving the program 
on disk. 

With a BASIC program in RAM, insert your MLLTIDOS diskette into drive 0, hold down the enter key, and 
press reset. When the MLLTIDOS prompt appears, enter *BASIC I". SUPERBASfC will be initialized with 
zero file buffers, previous TOPMEM, and the program text retained. 

BASIC # Recover a LEVEL II BASIC program. 

BASIC #<ENTER> 

This command is used to transfer a program from LEVEL II BASIC to SUPERBASIC, providing proper 
entry to LEVEL II BASIC was first made via CMD"X" from SUPERBASIC This feature will alow you to 
work in a LEVEL II environment to develop programs or to transfer a sensitive LEVEL 11 program from 
tape to disk. 

MLLTIDOS uses SUPERBASIC 1 * CMD'X" function to enter LEVEL II BASIC. You may use CMD"X n with or 
without a program in RAM. If a program is in RAM, it will be transferred to LEVEL II BASIC with text 
retained. This function is provided in Ecu of "BAStC2 I , since tt can completely incorporate the "BAS1C2" 
function whle maintaining the program in RAM. 

To exit from LEVEL II BASIC to SUPERBASIC with the program intact, type "SYSTEM", answer the "*?" 
With "/164S0", hold down the enter key and wait for the MULTIDOS prompt. Enter "BASIC #* as shown 
above. 

SUPERBASIC will load with your program's text retained, 



SUPERB ASIC 
BBASIC Enhanced SUPERBAS1C 

BBASIC has all of the features of SUPERBAS1C with the addition of aD of BOSS'S single step, trace, 

variable review, and program pushing functions. Upon entering BBASIC, a new keyboard driver ts activated, 

changing the key with the T '@ 11 symbol to a control key. The "©■ character is printed by pressing 
SHIFT-SPACE-BAR. 

There are several additional functions avaBable with BBASIC These functions are invoked by pressing down 
the key with the "©" symbol first then, without removing your finger from this key, press one of the keys 
on the top row of the keyboard. Some of these same functions can be obtained thru program execution by 
poking an appropriate number into 16567 decimal or 411 B hex. (This is ROM's trace on/off byte.) With the 
incorporation of these new trace functions, the TRON and TROFF functions are disabled. 

The particular functions will be described with the "@* symbol preceding a character. This represents 
pressing the n @ n key along with the key following the "g^. 

m TRACE OFF 

This will turn off aS trace functions. 

&7 TRACE ON - VIDEO 

This function will trace line number execution in the upper right hand corner of the display. 
The last four lines executed will be displayed. As a new line is entered its number will 
appear prefixed by the "#" sign. If more than four lines have been executed the trace wBI 
start at the top and overprint the previously displayed trace functions. 

@3 TRACE ON - PRINTER 

This function will direct the trace to the printer in the format " jS£", requiring 6 
characters for each line number. 

NOTE: The trace information wfll show the complete program flow, but wBI onh/ be printed when an 
entire print Dne is avaiable. This is because the printer will not output any dau until a 
complete print line is sent. If a character at a time printer b being used, the trace 
information will be printed as each program line number b executed. The print format for a 
trace to printer b space, 10k digit, Ik digit, TOO's digit, 10's digit, and unit digit. Zero 
suppression h used and each Tine requires six character positions. This fits in well with 72 
character per line (12 line traces} and 132 character per tine (22 Bne traces) printers. Thk 
output can be coctroBed by any type of user linkup to the printer device control block, since 
it is raw space/numeric output. No linefeeds, carriage returns, or control characters are sent. 

©4 SINGLE STEP OFF 

This function will turn off all single step functions. 

<?5 SINGLE STEP TO THE END OF LINE 

This function will execute one program fine then wait. 

©6 SINGLE STEP INSTRUCTION 

Thb function will execute one BASIC instruction then wait. 
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m SINGLE STEP WITH TIMED WAIT 

Thh function w3l execute one program fine or instruction, pause for a predetermined amount 
of time, then continue. 

SINGLE STEPPING 

You can single step individual lines of a BASIC program or individual instructions within a line. In addition, 
you can vary the delay In which your program steps between Snes or hdvidual instructions. There are four 
single step commands. 

551 - Single step off 

Pressing *@4 n will turn off the single step function and alow your program to run as normal. If the trace 
function was in use, it wQE continue to function until turned off. 

552 - Single step to end of fine 

Pressing "@5* will cause your program to pause at the end of each Ene untB any key ts pressed. The trace 
to video display mode wfll also be initiated to show you which Sne number b being executed. This trace 
mode can be disabled by a "©)", whle the single step mode continues. 

553 - Single step instruction 

Pressing n @6 n will cause your program to pause when an instruction separator, :, is found. Press any key 
to continue to the next instruction. Again, the trace to video depiay mode wDl be inttiaEzed to show you 
which Ene number b being executed. Thb function can be useful, but be wary of using it if a program 
contains Enes such as: 

90 FOR X=l TO 100;A(X}=6+3*X*Z:NEXT X 

To single step through this loop would require 300 presses' of a key. Instead use "single step to end of 

Sne. 1 

554 - Variable delay step (auto Step} 

Pressing "©7" will cause your program to delay approximately (125 seconds at the end of each fine. Again 
the trace to video will be invoked to show you which Ene number is being executed. 

"g>5" and "e^* become sub-commands after *©7" ts initiated. Pressing "@6" after 'QT* b initiated wHl 
cause the delay to occur at an instruction separator, in addition to the end of a Bne. Pressing "@5" wfll 
cause the delay to occur at the end of % Ene only. Thb delay has nine settings from approximately 4 
miiiseconds to approximately 03 seconds. To speed up execution (decrease delay) press "@up-arrow". To 
slow down execution (increase delay) press "#down arrow 1 . The amount of delay can be adjusted any time 
after BBASIC b initiaEzed. The initial setting provides 025 seconds delay. The amount of delay b halved 
each time "£>up-arrow" b pressed, or doubled each time "©down-arrow" b pressed. During this delay, key 
presses are not recognized. 



Pjcc *Ld 



SUPERB ASIC 

BREAK POINTS 

The trace and single Step commands previously described can be invoked by your program whle it s 
running by inserting a POKE instruction in your program at the location where you want to invoke the 
command. The following codes are used: 

FUNCTION POKE 16667 . 

TRACE off 1 

TRACE to display 2 

TRACE to printer 3 

SINGLE STEP off 4 

SINGLE STEP line 5 

SINGLE STEP instruction 6 

SINGLE STEP delay 7 

EXAMPIES OF BREAK POINT USE 

If you want norma! program execution to fine 1540, then single stepping with trace to the screen; insert 
just prior to iine 1540, the instruction "POKE 16667,5". 

EXAMPLE 1 EXAMPLE 2 

1530 (users text) 1530 (users text) 

1535 POKE 16667,5 1540 POKE 16667,5 : (users text) 
1540 (users text) 

NOTE: If your program logic has GOTO's, GOSUB's, etc, be sure to position the break point where the 
code will be executed. 

Multiple POKE'S are permitted; 

POKE16667,7:POKE16667,6:POKE16667,l 

This will invoke "variable delay step" between instructions with the trace disabled, 

NOTE: You can insert as many break points in your program as you desire. 

REVIEWING VARIABLES 

BBAS1C will suspend program execution to review selected variables and then return to your program with 
the dismay restored to that shown before you reviewed the variables. There are two commands used for 
this function. 

<£N = select variables for review 
@Q = review the selected variables 
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SELECTING VARIABLES 

Pressing ««N" will aBow you to select the variables you want to review during program execution. 
This command can be entered at any time before you run the program or during program execution. 
After invoking "3N», the query "Length? ' will be displayed. Respond from the following choices: 

RESPONSE RESULT 

BREAK exit function & return to BASIC program 

1 1 character variable names 

2 or 3 maximum of 3 character variable names 
4-7 maximum of 7 character variable names 
8-15 maximum of 15 character variable names 
16 - 31 maximum of 31 character variable names 
ENTER default to maximum of 7 character names 

The maximum number of variables for review is Imlted by the maximum variable name length 

selected, as shown below. 

NAME LENGTH NUSfcER OF VARIABLES TO REVIEW 
1 maximum of 128 

2—3 max Imum of 64 

4_7 maximum of 32 

g_l 5 maximum of 16 

16_31 maximum of 8 

NOTE' The name length includes all characters. The variable name A$(21,5) is considered to have a 
length of eight (8). F(R(3,8)} is nine characters in length. After successfully entering a variable length, 
the message 'Input variables' will be displayed and al previously entered variable cho.ces wBl be 
erased. This function will alow you to enter variables using the foBowing syntax: 

A XI B# Q!{F(G ( QJ) 

K* A!{F(G,Q)} F(2,3) T#(F, (B(A,N) ,G(E) ) ) 

A(B) WEEKDAY S% A(B,C) 

Any number of parentheses are aSowed, provided you close them within the variable length entered. 
Although HIegal variable names such as A*3 or A(3H) are not rejected, they wBl cause errors later 

when review of the variables is attempted. 

When you have finished entering the variables, press <BREAK> to continue with the review. If you 
enter the maximum number of variables alowed, BBAS1C wll automatical proceed with the review. 
At this point BBASIC invokes an n @0" as described below. 

Pressing "§0" at any time during program execution w» immediately save the contents of the video 

display and replace it with the message: 

,n C* = change, *D" = delete, "I" = insert 1 

wBl appear along with the first variable for review and its value. Variables are displayed in the order 

entered by the *@bi" function. 

NOTE: If there is insufficient memory to save the contents of the video display then a smal graphics 
block will appear in the upper right hand portion of the screen. 
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Pressing "CLEAR" will cause the message 

"End of variables." 

to appear. If you are really finished with the variable review, press "CLEAR" again and your original 
video display will be returned. Your program wBl resume execution at that point. If, instead, you want to 
review more variables, press any key other than "CLEAR". 

Pressing "C" will allow you to select another variable in place of the last variable displayed. The new 
variable selected and its value will be displayed. Remember, the variable name is limited in length per your 
original choice when "@N B was selected. 

Pressing "D" will delete the last displayed variable. 

Pressing "I" will insert a variable PRIOR to the last displayed variable. 

Pressing any key other than "CLEAR", "C*, "D", or "l" wBl advance the display to the next variable 
selected. 

If you attempt to review a variable whose subscript is out of range or with an illegal name, the message 
'ERROR, RE-ENTLR 1 will be displayed and the "C B command will automatically be invoked. You must select 
a valid variable to exit from this sub— command 

If you evaluate an element of an array (subscript < 11) and the array has not yet been dimensioned by 
your program, this array will be dimensioned for eleven elements (0-10). If your program subsequently 
attempts to dimension this array via the "DIM" instruction, an error wB! occur. Dimension aH used arrays 
before you review them with the review variables function. 

STACKING BASIC PROGRAMS 

You may stack one or more programs in high memory whie you work on or run antother program. Of 
course, this ablity b limited by the amount of free memory space avalable. You can retrieve the stacked 
program(s) at wBl. There are frve major commands for this function. 

(§>- = Save the current BASIC program in high memory 

@: = RecaH the last saved program from memory 

®8 = Append the last saved program to the current program 

<$9 = Append the next to last saved program to the current program 

@0 = Recall the next to last saved program 

Pressing @- will save the resident program in high memory and wiB automatically adjust memory size to 
the beginning of the pushed program, thus protecting ft from BASIC Your current program will also be 
left avalable in BASIC RAM, if memory permits. Since memory size is adjusted, subsequent pushes can be 
made as desired. When a program is pushed, a graphic vertical bar wBl appear in the upper right hand 
corner of the video display. This bar indicates that a program has been pushed into high memory and a 
program is in BASIC memory for user execution or modification. If insufficient memory b avalable to push 
your program and abo maintain it in BASIC RAM {Le^ trying to push a 30K program in a 4SK machine), 
your program wii be pushed and a "NEW" invoked. This condition wB! be indicated by a clear screen with 
a smal graphic block in the upper right of the video display. 

Pressing @: will pop or retrieve the last saved program from high memory. The resident program will be 
lost. Memory size will automatically be adjusted. If no saved program remains, the error message 
"NOTHING TO POP" will be displayed. 
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Pressing ®0 will retrieve the next to the last saved program from high memory. The resident program will 
be lost. If you want to switch the resident program with the tast saved program first push the current 
program via the @- command and then retrieve the next to the last program via the @0 command. 

Pressing @8 will retrieve the last saved program and append ft to the resident program. 

Pressing @9 will retrieve the next to last saved program and append It to the resident program. 

Line number sequence is mandatory for proper execution of the appending commands. The sucked program 
should have its lowest tine number greater than the highest fine number In the current program in BASIC 
ram. These commands append, they do not merge. 



SUPERBASIC ENHANCEMENTS to LEVEL II BASIC 



SHORTHAND 

Single keystroke commands: 

(per i od) 
, ( comma) 
/ (slash) 
up— ar row 
down-arrow 
shi f t-up-ar row 
shift-down-arrow + 2 



list cur rent I ine 

ed i t current I i ne 

i ist "BREAK in" i ine 

list previous i ine 

list next 1 i ne 

list first program tine 

list last program i ine 



The above single keystroke commands MUST be the first entry after the BASIC prompt, '>', appears. 
Single letter commands: 



C = continue program execution 
D[ . ] = delete current line 
E[ . ] = edi t current I ine 
L[ . } = list current I ine 
Mlnl,ln2 = move Inl to In2 

Mini,. = move Inl to current line 
M.,1n2 = move current line to In2 
Nln1,ln2 = duplicate Inl as ln2 

Nin1,. = duplicate ln1 as current line 
N.,ln2 = duplicate current line as In2 
P = list page from current line 
Pn = list page from line "n" 
R = run program 
R"filespec" = run filespec 

The above commands must be followed by <ENTER>. 

To n s t a lire just type in the line number followed by <ENTER>. Variables are 
kept. To delete a line you must use D or DELETE, followed by the line number 
(optional), followed by <ENTER>. 
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The 'M' command will relocate In! to In2, deleting til, and inserting it as In2. If ln2 existed prior to the 
move it will be replaced by the In2. The »." may be used to refer to the current line. 

The *N' command will duplicate Inl as In2 whle leaving In1 intact. If !n2 existed prior to this command, it 
will be replaced by the new line In2. The »." may be used to refer to the current line. 

SUPERBASIC allows you to use abbreviated commands. 

To list the current line, type ».\ n L<ENTER>", or "L. <ENTER>« . 

To edit the current line, type \ " , H E<EN7ER>\ or "E.<ENTER>". 

To delete the current line, type "D<ENTER>" or H D. <ENTER>" . 
The "-" can be used in conjunction with the H L" and "D r . 

To list everything from the first program line up to the current line, type 
"L-,<ENTER>". 

To list the entire program, type "L-^NTER^. 

The symbol "J" will Est the last fine for which the "BREAK IN LINE W message was issued. The default 
fine 0, if no break has occured, b the last line of the program. 

The up-arrow will display the preceding line whie the down- arrow will display the next fine. The shifted 
up-arrow will display the first program line. The shifted down-arrow will display the last line. 

EXAMPLES: 

In each example the following BASIC program is in memory 
and the ine pointer points to fine #20. 

10 For X= 1 to 20 

20 PRINT X, X*X, X*X*X 

30 NEXT X 

40 END 

(1 } L<ENTER> 

Line 20 will be displayed. 
(2) L-.<ENTER> 

Lines 10 and 20 will be listed, 
{3) L.-<ENTER> 

Lines 20, 30, A 40 wi I I be Us ted. 
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&H and &0 Hex and octal constants. 

4[H]dddd 
AOdddd 

This command aBows you to use hexadecimal (base 16) or octal (base 8) constants within your program. 
The "H" is optional in SUPERBASIC 

EXAMPLE: 

X = &4000 This assigns 16384 to the variable X. 

Y = &6000 - &5200 This assigns 2584 to the variable Y. 
POKE &FFFD, 4 This puts a 4 in RAM location -3 (65533). 



CMD'C 1 Space compression. 

CMD"0<ENTER> 

This command wili eSminate spaces and linefeeds within the resident program in RAM, at the rate of 
approximately 8000 bytes per second. This command wilt not remove spaws or linefeeds which are in 
quoted text, data statements, or remark statements. This command alows you to remove unnecessary bytes 
from your program, resulting in more free memory space and faster program execution. To remove 

remark statements use CMD"U". 



CMD'D 1 Load and execute DEBUG. 

CMD n D n <ENTER> 

This command causes DEBUG to be loaded and executed. To return to the point from which you entered 
DEBUG, type "G<ENTER>". For a complete description of the DEBUG facBity see the 
LIBRARY COMMAND section. 



CMD*E" Disk I/O error. 

CMD"E"<ENTER> 
This command wBl cause a brief explanation of the last DOS error code to be displayed. 

CMD^* Zero array. 

CMD , K"w(0[,0_]) 

vv = Any vaid variable name 

This command wll zero the array vv(dim[,dtm_]) where -dim refers to the originaBy dimensioned values of 
the array. AH elements of the array will be set to zero. 
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EXAMPLE: 



{!) 100 DIM A%(6,7,4) 

110 More program fines 

690 More program Dnes 
700 CMD "K" A%(0,0,0) 
710 More program lines 

In the example above, A% was dimensioned as a 280 element array. After fine 700 is executed, A% is stBI 
a 280 element array and each element has the value of zero. 



CMDV Delete array. 

CMDVvYfOf.O-]} 
vv = Any vaid variable name 

This command will dynamically delete the array vvfdirn[dim>.]) and free the memory space for 
SUPERBASIC use. After using this command you can redimension the array. 

EXAMPLE: 

(1) TOO DIM A%(6,7,4) 

110 More program lines 

690 More program lines 
700 CMD V A&(0,0,0) 
710 More program lines 

in the example above, A% was dimensioned as a 280 element array. After fine 700 is executed, the array 
A% no longer exists and the amount of free memory is increased. 



CMD'O" Open an additional fie buffer. 

CMD^O' 

This command aiocates an additional fie buffer. When SUPERBASIC b irvtiaized it aBocates space for three 
fie buffers. If you caused fie buffers to be aiocated at initial z a tion, onh/ that number has been reserved. 
CMD»0" alows you to alocate additional buffers from the direct mode in BASIC or from within your 
program. The RAM location indicating the number of open buffers is 521AH (21018 D). DO NOT POKE 
THIS LOCATION!!! 

DO NOT execute this command from within z subroutine or a FOR-NEXT loop. 
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EXAMPLES: 

(1) From the direct mode, the fallowing command b typed: 

CMD t, R <ENTER> 

This results in one additional file buffer being allocated, with most variables retained. Strings created via 
READ, direct string assignments, and DEFFN will not be retained. 

(2) Using CMD H 1 ' within a program 

10 DIM A(20), B$(15) 

200 CMD n O" 

210 OPEN "RV/TESTFILE/TXT 1 ' 

Line 200 allocates a fUe buffer which b opened in line 210 

(3) 100 IF X>15 then 300 

110 ON ERROR GOTO 900 
120 OPEN n E n ,X,Bt 

300 PRINT "MAXIMUM f FILE BUFFERS OPEN»:END 

900 IF ERR = 104 THEN CMD n O« ELSE PRINT ERR/2+1: END 

910 RESUME 120 

The above error trap will cause additional fie buffers to be alocated each time fines 100-120 are executed. 

(4) To open five buffers, without allocating additional ones each time the program b run, the 

folowing line could be used: 

15 IF PEEK (A521A) < 5 THEN CMD a O": GOTO 15 



CMDT" Pack program lines 

CMD n P»<ENTER> 

This command will pack BASIC program lines together and maintain program logic. Upon invoking the 
command the prompt: 

Maximum Bne length 

will appear. Enter the maximum number of characters that are to appear in a program line. Enter any 
value between and 65535. Entering a w9l cause the packer to pack ines to a maximum of 65536 

characters. 
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A second prompt wfll appear: 
First 

Enter the line number of the first flne of the program that b to be packed. The final prompt will then 
appear: 

Last 

Enter the last program line that b to be packed. If the value entered for the last" is less than or equal 
to the "First" then you will be re-prompted for the first and last tines. 

The packer wfll then anaize the program for logic and check for some minor errors. If any errors are 
present in the program then they wQI be displayed on the video. They are: 

SN in # = syntax error in line 

OV in f = overflow error in Kne 

UL f in f - undefined fine number in line 

where $ is a line number 

OV and UL usually occur on branching instructions (such as GOTO*, GOSUB* etc) and denote either a line 
number that is too high or a reference b made to an undefined Ine, respectively. 

If any errors occur the program wfll not be packed. Should no errors occur the program will be packed 
and spaces wHi abo be removed. 

The packer does not renumber the program. It packs lines using the folowing rules: 

Lines which are referenced are not packed to a previous fine. 

Lines which contain IF statements are not packed to the foBowing line. 

Lines which contain REM and ' statements are not packed to the foBowing fine. 

NOTE: In the BASIC program, that b to be packed, you must have an ending quotation mark for string 
constants (messages enclosed tn quotes) or packing the program may destroy logic 



CMD^Q" String sort. 

(1) CMD"Q',M f w*(0) 

(2) CMD"QWv$(rj*0>2 

vv$ = Any vaid array variable name 

nl = An integer or integer variable representing 

the number of elements to be sorted, 
n2 = A positive integer or integer variable 

repr esenting the coajmn number to sort in a 

two dimensional array. 

Thb command wBt provide for a quick sort of a string array. Typicaly, a 1000 element array will take 
less than seven seconds to sort. 
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The sort ts performed In accordance with the sign of n1. If nl Is positive, the sort wilt be in ascending or 
alphabetical order. If nl is negative, the sort wPI be in descending or reverse a^habetical order. 

VERSION (1) is used to sort a single dimensioned array. The array w8l be sorted up to the nlth element, 
including the Oth element. Version (2) Is used to sort a two dimensional array with n2 indicating which 
coiumn of the array to use as the sort key. 

EXAMPLE: 

10 CLEAR 600: DIM A${10) 

20 FOR I = 1 TO 10 

30 READ A$(i) 

40 NEXT I 

50 DATA "WASHINGTON", "OREGON", "CALIFORNIA", 

"NEVADA", "IDAHO", "UTAH", "ARIZONA", 

"MONTANA", "WYOMING", "COLORADO" 
GO CMD*Q",l,A$(0) 
70 FOR 1=1 TO 10 
80 PRINT A*(l), 
90 NEXT I 

The prritout wQI be as follows: 



ARIZONA 


CALIFORNIA 


COLORADO 


IDAHO 


MONTANA 


NEVADA 


OREGON 


ITT AH 


WASH 1 NGTON 


WYOMING 







NOTE the folowing key points of the EXAMPLE: 

1. The Oth element was not used (it k a null string). 

Z The value of 1 in line 60 is actually 11. CMD 8 Q" wBl not cause an error if the value of nl is greater 
than the first dimension of the array. 

3, If only line 60 were changed to: CMD"Q",-l,A$(0) 
the printout would be as folows: 



WASH I NGTON 


UTAH 


OREGON 


NEVADA 


MONTANA 


IDAHO 


COLORADO 


CALIFORNIA 


ARIZONA 









What happened to "WYOMING"? Ifs in the Oth element A$(0)="WYOMING , and A$(10)="". 

4. If only line 60 were changed to: CMD"Q*,6,A$(0) 
the printout would be as folows: 

CALIFORNIA IDAHO NEVADA OREGON 

UTAH WASHINGTON ARIZONA MONTANA 

WYOMING COLORADO 

Only the elements A${0) through A$(6) were sorted, leaving A$(7) through A$(10) as loaded from the data 

statement. 
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CMD'R" Enable Interrupts (MODEL I only). 

CMD"R"<ENTER> 
Thb command enables the Interrupts. 

CHD^ 1 Return to MULTIDOS. 

CMD B S , <ENTER> 
Thb command returns you to the MU|-TIDOS operating system. 

CMD*!"" Dbable Interrupts (MODEL I only). 

CMDT«<ENTER> 

Thb command disables the Interrupts. Thb command b invoked automatically when CLOAD, CSAVE, or 
SYSTEM b entered in the command mode. Other cassette operations such as INPUTjH, ">d PRiNT#-1 
MUST be preceded by thb command. 

CMD , U" Remove REMark statements 

CMD"U"<ENTER> 

Thb command removes REMark statements from a BASIC program in RAM. Both REM and ' type remarks 
are removed. If a »ne consbts of oniy a remark statement then the entire Sne wil be removed. If only 
part of a program fine consbts of a remark statement then only the part that b the remark text wBI be 
deleted from the fine. After the remark statements are removed the renumber utlity b called to check 
for mbslng line numbers; The program b not renumbered. 



CMD"V" Scalar variables. 

CMD"V"<ENTER> 

Thb command wttl display al assigned scalar variables and string equivalents in the order they were 
created. 

The screen wil clear and up to 12 variables wil be dbplayed. Press any key to dbplay an additional 
variable or <ENTER> to dfepiay up to 12. Thb function fa complete when you receive the "READY" 
prompt. However, you may embed thb command inside a BASIC program, which wit require user 
intervention for program continuance. 
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CMD^" Transfer to LEVEL I U 

CMD"X"<ENTER> 

Thb function will transfer the resident SUPERBASIC program to the LEVEL II BASIC environment whle 
retaining memory protection and a printer driver pointer! if deferent than MULTIDOS's. In addition, It will 
seed the "DEBUG AREA" (starting at 4O60H) with a semi-recovery program to aid In return to the DISK 
BASIC environment. Refer to "BASIC #■ for direction on re-entry to SUPERBASIC from LEVEL II BASIC 

This command can be very useftJ If you want to work on a program which wit normaly be run in a 
LEVEL II environment. You can develop the program In SUPERBASIC, test it in LEVEL IL and return to 
SUPERBASIC 



CMD'uuuuu" Execute a MULTIDOS function from SUPERBASIC 

CMD"uuuuu"<ENTER> 

uuiriu = Any vald MULTIDOS command 

Thb command alows you to use any vald MULTIDOS command, including BASIC, from within the 
SUPERBASIC environment. The command can be used in the direct mode or as a statement within your 
BASIC program. Your program wll be protected whle the command is being processed. You can even use 
complex MULTIDOS commands, such as loading and executing machine language programs provided those 
programs use TOPMEM (4049H - MODEL 1, 4411H - MODEL ill) as the upper memory imits and wll fit 
into the remaining RAM. Thb command requires a minimum of 6074 free bytes to execute. 

EXAMPLES: 

(1) CMD"DIR" 

The directory contents wll be dbplayed. 

(2) CMD"BACKUP" 

BACKUP/CMD wDI be loaded and executed. Upon completion, 

your BASIC program wll resume execution at the next Ine number. 



DEF FN Define function. 

DEFFNxxx(uuu[,uuu— ])=www 

xxx = Name of the function and b any vald variable name. 

uuu = Variables used by the expression. 

www = An expression or formula usualy involving the variabie{s) (uuu) passed on the left side of 
the equal sign. 

Thb statement lets you create your own implicit function. After a function has been defined, you use the 
function as any of the other intrinsic functions, e.g* ATN; COS^ ASC, etc 
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The type of value returned wilt be the same as the type of variable used to name the function. In addition, 
the variables used in the DEFFN statement have no effect on the value of that variable. 

EXAMPLE: 

10 DEF FN Q(KL) = K/20 + L/10 

20 INPUT "Enter quantity of nickels and dimes B ;N,D 

30 PRINT "The amount in doHars ts";FN Q (D,N) 

The function Q (FN Q) is defined using K and L, but the variables tn line 20 and 30 are N and D. K and 
L may be used in the program and have no effect on FN Q, nor does FN Q definition using K and L have 
any effect on the variables K and L The space between DEF and FN is optional, DEFFN is acceptable 
syntax. 



DEFUSR Define entry address of USR routine. 

DEFUSRn=aaaaa 

n = The digit 0-9. If n is omitted is used. 

aaaaa = The entry address to a machine language routine, 
aaaaa may be any numerical expression, including 
cons tants , var i ables, or funct ions. 

EXAMPLE: 



10 CLEAR 500: DEFINT A-Z 

20 N = 8000 

30 DEFUSR 5 = N * 4 

Defines 32000 decimal to the USR 5 call. 



INSTR String search. 

!NSTR([p,]stringiubstring) 

p = Position in the string where the search is to begin, 
string = The name of the string to be searched. 

sii)string = (1) The name of the substring for which you are searching, or {2} The actual substring 
for which you are searching 

This function searches through "string" to see if it contains "substring 1 , if it contains "substring", INSTR 
returns the starting position of "substring" in "string"; otherwise zero is returned. 

If "substring" is a null string, INSTR returns zero. 
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EXAMPLES pet Z$="SUPERBASIC», W$=", X$="SUPER") 
Expression Result 



INSTR (Z*,"PER") 3 

INSTR (Z$,"TRS«) 

INSTR (2,Z$,W$) 

INSTR {3,Z$,"U") 

INSTR (Z*»X$) 1 

INSTR (2,Z$,X$) 

INSTR (4, Z$, "BASIC") 6 

INSTR (3,"ABCOABCDABCDABCD«,"ABC") 5 



UNEINPUT Input a string from keyboard. 

UNEINPUT["messageV]w$ 

message = A prompting message 
w$ = A vafd variable name 

This BASIC statement alows you to input a complete Sne from the keyboard including punctuation, and line 
feeds. A space b permitted between LINE and INPUT fl_INE INPUT). This statement nulls the variable, does 
not print a question mark, alows the entry of only one string variable, and recognizes leading spaces. 



U5T Display program text. (Model I only, Mode! Ill uses ROM code) 

UST<ENTER> 

This command has been modffied to show graphic characters included in quoted text. You will not get a 
string of BASIC reserved words. The actual graphics wll be displayed. Editing of these packed strings is 
alowed, with the EDIT function, as long as the "A" command is not used. (If you accidently enter an "A" 
command, use the "Q" command to abort ft.) 

MtD$= Replace portion of a string. 

MlD$(vvJj)[,c])=rr$ 

w$ = The variable string to be changed. 

p = The starting position within the string for the replacement 

c = An optional parameter indicating the number of characters 
to be replaced. 
rr$ = The replacement string. 

This command lets you change part of a string. The length of the target string (w$) fe not changed by the 
MID$ = statement. The excess characters to the right of (rr$) would be ignored if the replacement string 
h too long. 



piv* an 



( 



SUPERBASIC 

EXAMPLES (let C$="1 2345678", D$="BASIC"J 

Expression Resultant C$ 

M1D$(C$ f 3,4)="ABCDE" 12ABO>78 

M1D$(C$.1,2)=D$ BA345678 

M!D$(C$,S)=»YZ" 1234YZ78 



TIME$ Get current RAM date and time. 

Thb b a BASIC function which returns, In a 17 byte string, the time and date in the form MM/DD/YY 
Wi:MM:SS 



USRn Execute a machine code routine. 

USR[nJ(val) 

n = A number from 0-9. The default value b 0. 
val = An integer or integer variable with vakie 
from -32768 to -f32767. 

Thb command transfers control to a machine language subroutine which was previously defined with the 
DEFUSRn statement. 

When a USR function b encountered in a statement, SUPERBASIC transfers the program counter (PC 
register) to the address specified by the correspondng DEFUSR statement. When the specified USR function 
b complete, via a RET or JP 0A9A instruction, the BASIC program w5l continue at the next statement 
fo lowing the USR function. 

To pass a vakie to the USR function, execute a CALL 0A7F as the first instruction in the USR routine. 

Thb cal wll transfer the value of "val" to the H. register pair. To receive a value from the USR 

subroutine, place the value into the HL register pair, then exit via JP 0A9A. The "val" variable wll contain 
thb value when SUPERBASIC continues. 

The last USR subroutine wOl have the LSB entry point in 406EH [16526 dec] and the MSB entry point in 
408F [16527 dec]. The USR fwction in SUPERBASIC, places the address here, then returns to ROM to 
execute the subroutine. You can circumvent the extended USR function by POKEing a value, C9H [201 dec], 
into RAM location 41A9H [(6809 dec]. Thb b the value for LEVEL It, (MULTIDOS Bade uses a C3H [295 
dec], at thb location, for the extended USR function). Next poke your subroutine's address into 16526 dec 
and 16527 dec to execute a LEVEL II program with USR cab in SUPERBASIC Add the instruction: POKE 
16809, 201 prior to executing the USR subroutine. 
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SUPERBAS1C overlay utilities. 

FIND Find ASCII characters (To 'find 1 keywords use REFERENCE). 

Ftar<ENTER> , 

This command will find al occurrences of "tar" in your BASIC program. The display will Indicate the ine 
the "tar" b found on, and if more than one occurrences are on this Ene a "/■ b printed foBowed by the 
number of occurrences. Spaces are recognized with thb command. 

EXAMPLE: 

F:<ENTER> 

10 20/5 50 70 90/3 

The ■:■, colon, character b in fine 10 once, flne 20 five times, fine 50 once, line 70 once, and in fine 90 
three times. 

EXAMPLE: 

F in <ENTER> 

Thb wBI FIND al occurrences of ■ in ■ in the resident BASIC program. 



GLOBAL EDITING (GE) - Mass editing BASIC program. 

-<ENTER> (a minus sign foBowed by <ENTER>) 

Thb SUPERBASIC feature wfll permit you to perform surgery on your BASIC program. You can change 
variable names, hems in a data Es^ integers, strings, etc. You can create compressed strings, merge fines, 
split fines, change reserved wor*, and more. 

The folowing types of operations are aBowed: 

- Change al or part of variable names. 

- Change al or part of constants, data fist hems, or string. 

- Change graphic codes as "CHR^x)" into packed string (x = 128-191). 

- Change space compression codes as "O^ty}" into packed string (y = 192-255). 

- Merge adjacent fine numbers into one long line. 

- Split one long line into two shorter ones. 

- Change reserved words. 
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GE - General changes: '" %<',.' ;,-. . 

To use the utility: 1 '" 1 ""'''' 1 ' " ; "\ 

(la) From tf» MULTlboii ready mo^de:^; t ; ' 

Load SUPERBASIC and 'your program, e.g. BASIC LOAD"pr°8r»m"<ENTER> 

(lb) From SUPERBASIC: , 

Load your BASIC program.' eg. LOAD"p ro B ram " < E NT ER> 

(2) Enter the global editor by Issuing the command: "-<ENTER>" 

The screen will be cleared and the folowing message will be displayed: 

Line Target 

T = 

This is the target (T) entry mode. Enter a target as fblows: 

To change a constant, a variable name, or item in a data Est which b not enclosed in quotes, respond with 
the item when the target b requested. The response must be from 1 to 255 characters long and must be 
terminated with the <ENTER>. 

To change a target which b enclosed in quotation marks, precede the target with the $ sign. The target 
must be from 1 to 254 characters and must be terminated with the <ENTER>. 

To change only a single character variable, whle leaving multi character variables with the same letter 
unchanged, enclose the target single character within single quotes ('X'). 

To change only the first character of a multi character variable, enter the target character folowed by a 
single quote (X 1 ). To change the second or greater character of a multi character variable, whle leaving 
the first character unchanged, precede the target single character with a single quote {'X). 

GE - Changes to reserved words: 

The global editor will alow you to change reserved words, such as "PRINT" to 1PRINT*. You must be 
careful, however, as lowercase b not acceptable. Under SUPERBASIC or LEVEL II BASIC, as each Gne b 
entered or edited, It b processed through a buffer. Thb buffer looks for reserved words and changes them 
to a one byte code. It abo converts al variables to uppercase. Since the global editor does not process 
changes through the buffer, do not use lowercase for reserved words or variables as a syntax error wll 
occur at run time. If your target b a reserved word or the arithmetic operators +, -, *, /, up arrow, >, 
=, or <, bracket this target with the "< * ■>■ characters. Le. <+>. 

After you have entered a target according to the rules above, you w3I be prompted to enter Line A, 
which b the first line to search and has a default vakie of your first program fine. You wll next be 
prompted to enter Line B, which b the last line to be searched and has a default vaaie of the last line of 
your program. Line A and Line B permit you to Imlt a change to a specific range of program fines. 
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Next you wil be prompted to enter the replacement for the target specified. To re-enter the target If 
you entered it in error, use the <ENTER> character at the replacement You wil be returned to the 
target entry mode. To delete al occurrences of a target use the <SH1FT># as the replacement. 

Finally, you wBl be asked if you want the above global changes to be made. This is your last chance to 
correct an error In your entries. Respond "Y" to the query "Use (Y/N)7" if you want the changes made. 
SUPERBASIC will then search your program for the target and make the changes. The screen wil show 
the Bne number being searched under the title "Line" and the last Bne number where a target was found 
under the title "Target". SUPERBASIC wil display a total of the target occurrences to Indicate completion. 

To exit from the GLOBAL EDITOR press <ENTER> after a successful change or press <BREAK> at the 
target or replacement queries. 

EXAMPLES: (> means changes to, T= fa the target, and R= Is the replacement) 

(1) To change al occurrences of the variable "B" to 

■F", T = B and R = F. 

B>F, AB>AF, BA>FA, BB>FF, BOFC, BD>FD, B*>F$, 
AB$>AF$, AJ(AB)>A$(AF) 

(2) To change al occurrences of a single "A" to "G", 

T = 'A' and R = G. 

A>G, A$>G$, A$(1)>G$(1), A$(A)>G$(G), 
A${AA)>G*(AA) 

(3) To change al occurrences of the first "A" in a 

miiti character variable to "H", T = A 1 and R = K 

AA>HA, AB>HB, AOHC, AD>HD, AE>HE, AA$>HA$, 
AB$>HB$, A$(AA)>A$(HA) J A$(AB)>A$(HB) 

(4) To change al occurrences of the second *A" In a 

miiti character variable to ■!■, without 
changing the first occurence, T = 'A and R = L 

AA>AI, BA>BI, AA$>AI$, A$(AA)>A$(Al) 

(5) To change al "E" in strings to "Z", T = $E, and R = Z. 

■ABCDE">"ABCDZ« 
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GE - Bu Icing compressed strings: 

If your program contains many »CHR${x)+CHR$(x)" statements, the global editor wll shorten It by buldng 
a compressed string. This can result in faster execution and more free memory. As an example, the line: 

10 A$<HRt(191)+CHR${129>"X»+CHR$(176) 

would require 32 bytes of memory. After the global edtor bult a compressed string, the line would be: 

10 A$= B -X." 

where the *J* represents a graphic character. The new length would be 14 bytes, or more than a 5096 
saving of space. 

To buld a compressed graphics string in place of CHR$(x) type fines, enter the "+■ character for the 
target. 

To buld a compressed string with space compression codes, enter the "*■ character for the target. 

The CHR$(x) OR CHR$[y) cannot contain blanks within the parentheses. CHR$( 191 ) is not acceptable and 
wBt not be changed. 

NOTE: The changed code will display properly. SUPERB ASIC wfll also fist It properly to the screen. 
However, since It h compressed code or graphics, it will not look the same when it b sent to a printer 
which does not have graphics capabilities. 

EXAMPLES: 

(1) ■+■ Changes 210 B$=CHR$ (1 31 )+»X"+CHR$ (176) 

to 210 B$=".X.« Where "."^graphics. 

(2) ■•■ Changes 337 PRINT CHR$( 204)+ "TEST" 

to 337 PRINT ■ TEST" 

(3) ■+■ Followed by the ■•■ 

Changes 400 A$=CHR$(178)+CHR$ (204)+CHR$(190) 
to 400 AJ=». .■ 

GE - Merging fine numbers: 

The global edtor wfil alow you to merge or append a program fine to the preceding fine in your program, 
it does not change references to the fine. As an example, if your program contained fines 1,2,3,4, A 5, and 
you merged Bne 3 to fine 2, then an error would resilt at run time if fine 5 originally contained 
"GOT03", because fine 3 no longer exists. Do not append to a line which contains an open quote (10 
A$=THlS IS). Close the quote first, then merge {10 A$= r THlS IS"). 

Thfc function will alow you to create fines greater than 255 bytes in length. The fines wDI execute properly, 
but can neither be properly Ested on the screen nor edited. 
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To use this mertfng function* respond with the ■/■ character and the One number to be merged as the 
target 

EXAMPLE: '.','""' 

10 A$="TEST /" 
20 PRINT A$ 

To merge the above two fines target b /20. 
The result b one Sne as follows: 

10 A*="TEST f ;PRINT A$ 

GE - Splitting lines: 

The global edtor wll alow you to split a program Bne containing two or more BASIC Instructions into two 
lines. 

The new line number can be any number greater than the Bne to be split and up to 65529. However, if 
you assign a new line number greater than the next Sne after the Ine to be split, run time errors can 
occur rf you make references to those in-between Bnes. 

As an example, if your program contains ines 10, 20, 30, 40, 50, & 60, and you split fine 20 into Bnes 20 
and 45, ines 30 and 40 will not be found by any reference instructions such as "GOTO 30", "GOSUB 40", 
etc However, If the program flow b such that BASIC would normaly process the next statement In RAM 
after the new fines 20 and 45, fines 30 and 40 wBI be processed. BASIC would, in the absence of any 
branching instructions, process Bnes 20, 45, 30, 40, and 50 in that order. 

The spilt point must be Erectly behind a colon (:) In the program Bne. To use the split function, the target 
is In the form -ttt where ttt b the target for the split. If the target b a reserved word such as 
"PRINT", enclose the target with ■<■ AND ■>» signs, If no target b specified, the line wll be split at the 
first colon. Line A now represents the Bne number to be split and Bne B represents the new Bne number. 

EXAMPLES: 

(1) 10 A$="TEST #":PR1NT A$" 

To split the above Bne, T = -, Line A = 10^ Line B=15. 

The result b: 
10 A$="TEST §* 
15 PRINT A$ 



c, 
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(2) 30 A$="ABCDE»:PRJNT A$:B$=»FGH":PR1NT B$ 

To spilt the above Bne it ":PRINT B$", 

T = -<PRINT> B$, Une A = 30, AND Une B = 35. 

The result b: 

30 A$=«ABCDE":PRINT A$: B$= M FGH" 
35 PRINT B* 



The global eoltor executes very rapidly. The creation of compressed string requires 67 iterations each time, 
so the ■*" and «+■ functions wll operate at'a slower speed. During operation, the editor will display the 
line being searched at the top of the screen. It wBI abo dispfay the line in which the target was last 



found. 



Be cautious about changing variables in a "DEF" statement The range must be ascending. If the 
replacement is larger than the target, your program wil be increased in size by that difference for each 
occurence. If you run out of memory ,*n "Out of MEM" error message wll be displayed. At this time al 
changes up to the point where memory was insufficient will be made. If this occurs there b still sufficient 
memory to reverse the changes or to make other changes which would decrease the program size. 



REFERENCE Cross reference variables and integers to 9999999. 

;[p][xxx]<ENTER> 

p = ■*■ if the reference feting is to be displayed on the screen or "$" if the reference listing is to 
go to the printer also, p b optional. 

xxx = Reference target which may be: 

(!) A one or two character variable name without 

a type suffix. 
{2) An integer number which may be a Ine number 

or a value used in the program. 
(3) A reserved word if preceded by a § symbol 

Target version (1) will show al Ine numbers which contain the variable specified. Target version (2) wBI 
show al ine numbers which refer to the integer specified. The reference may be as an integer in the Bne 
or to a Bne number. Target version (3) wBI show al line numbers which contain the reserved word. 

After a reference target has been made, you may dbpiay those Ines by pressing the ";" key. Each Ine 
referenced wBI be dbptayed sequentialy and may be edited before the next Ine b called. 

Use of the p option without a xxx target wil result in a reference Isting of al integer numbers and 
variables. If the p option fe used with a xxx target, a reference Isting wll be produced storting with the 
target and proceeding in ascending order. If the reference Isting b requested in the form ";p^<ENTER>", 
a fisting of reserved words wll be produced. The reserved word Isting b produced In the order 
ROM-BASIC "TOKEN1ZES" (converts to compressed storage) the reserved words. This b not afehabetical 
order. 
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ume the Ssting, press any key^ To abort the 

c 



To pause during a reference Hsting, press shift #. To resume the Ssting, pres* any key^ To abort the 
reference listing, <BREAK>. - ~. 



EXAMPLES: 

(1) ;*<ENTER> 

AM integer and variable references are displayed on the screen. 

(2) ;K<ENTER> 

AM references to the variable ■K" are displayed on the screen. 

(3) ;$G<ENTER> 

All variable starting with "G" and continuing through "ZZ" will 
have their references directed to the line printer. 

(4) ;#PRINTT<ENTER> 

All line numbers which contain the reserved word "PRINT" will 
be displayed on the screen. 

(5) ;$#<ENTER> 

All reserved words will have their references directed to the tine 
pr i nter . 

When a reference is displayed or printed for any target, the line number containing the reference Is 
displayed and may be followed by one or more of the foBowing modtfters: 

/n where n = the number of references to the target 

within that line. 
/$n the variable contains the string designator "4". 
/%n the variable contains the integer designator ■%". 
/In the variable contains the single-precision designator "I". 
/#n the variable contains the double-precision designator ■#". 
(the variable Is used as an array variable In this line.} 

RENUMBER Renumber a BASIC program. 

(1) :<ENTER> 

(2) :[nn][;iil[ 1 ssslI,eee]<ENTER> 

This function wfll alow you to check for missing or invald Ine numbers within your program, recover a 
■NEWED" program, and renumber al or part of your program. 

To check for errors use format (1). SUPERBASIC wtl scan your program for reference operators 
(GOTCs, GOSUB's, ON"s, ERL's, etc). It wll look for missing Ine numbers, and overflow or Improper ine 
numbers. 
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When format (1) b used, the message "ONLY CHECKING FOR ERRORS' wll appear on the screen. If any 
errors are found, the message Error{s)' wHI appear, folowed by the line number causing the error and the 
error type. If no errors are found the message "Function completed 1 will be displayed. 

Error types are: 

I III l/U(nnnnn) Line number Mill Is referenced In 

line number nnnnn but does not exist. 

Eltll/S Line number 1111! contains a syntax error. 

Illll/O Line number Kill contains an improper 

line number (>65529). 

To recover a program Immediately after you have typed "NEW", use FORMAT (1). This wll force a 
rescue of the program. If you estabish a variable between the "NEW" and the ":\ the results are 
unpredictable, and probably wW not be what you wanted. To renumber your program, or parts thereof, use 
format (2) as shown above where: 

nnn = The first line number to be assigned to a renumbered 
inc. nnn must be in the range of To 65529, The 
default value b 10, 

ii = The increment to be used tn renumbering. The default 

value is 10. If used, 5i must be preceded by a comma. 

sss = The starting point in the original program where 

renumbering b to occur, sss must be <= nnn and 
has a default value of Ot 

eee = The ending point in the original program where Bne 

renumbering b to stop, eee must be >= sss and has a 
default value of 65529. The ending Pne b not 
renumbered. 

SUPERBASIC wll check your program for. errors before attempting to renumber. If any errors are found 
they wll be dfepiayed and control w8l be returned to you with your program unchanged. 

EXAMPLES: 

Sample program 

10 PRINT "TEST" 

20 GOTO 290 

30 INPUT A 

40 ON A GOTO 10^0,60,70 

50 GOTO 10 

60 PRINT A 

70 PRINT A*2 

80 GOTO 70000 

90 END 
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(1) The command ■:<ENTER>" would generate the following messages: 

'Only checking for errors - [ 

Error{s) 

290/U{20) 40/S 80/O 

Function completed 

READY 
> i 

(2) After fixing the above errors, the command 

■:5V,5(V70<ENTER>" would generate the 
folowing renumbered program: 



v 



10 PRINT 


■TEST" 


t 


20 GOTO 


90 




30 


INPUT 


A 




40 


ON A 


GOTO 


10^0,51,70 


50 


GOTO 


10 




51 


PRINT 


A 




70 


PRINT 


A*2 




80 


GOTO 


10 




90 


END 







SUPERBASIC fie manipulation. 

K1L Delete a file from a diskette. 

KILLvar$ or KU^flespec 1 

var$ = a string defined as a flespec 
fflespec = a fie specification for an easting fie. 



Thb command alows you to delete a fie from the directory. If the statement is within the program, you 
must be sure to close the fie first. From the command mode, SUPERBASIC and MULTIDOS close al fles 
before the directory b changed. 
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LOAD Load a BASIC program to RAM. 

LOADvar$[,R] or LOAD^espec^.Rj 

var$ = a string defined as a flespec. 
flespec = a vald BASIC program fie name. 

This command alows you to toad a BASIC program from diskette. The " J R" option wQI load and run the 
program without closing any previously open Ses, which were opened via an OPEN statement. 



MERGE Combine two programs in RAM. 

MERGEvarJ or MEftGE■fiespec , . _ 

var$ = a string defined as a flespec. 
flespec = a BASIC program saved using the ASCII option. 

This command combines two program segments within SUPERBASIOs memory space. The program Dnes in 
var$ wBI be inserted into the resident program in sequential order. If line numbers in var$ coincide with a 
ine number in the resident program, the resident Ine wfll be deleted. 



NAME Load an execute a program keeping variable vahies. 

NAMEvar$I,R] or NAME^espec^.R] 

This command is SUPERBASIOs chaining function. It alows you to run BASIC programs which are too 
large to fit in memory. This, command wfll cause SUPERBASIC to load and execute the fie var$ or 
flespec beginning with the lowest fine number as ff it were a new BASIC program. The previous variables 
wil remain intac^ except for DEFFN, strings created via READ, or string assignments directly in a BASIC 
program. If the ^R" option is specified, the files wfll remain open. 



RUN Load a BASIC program and execute. 

RUNvar$[,R] or RUN"flespec"[,R] 

Thfe command allows you to load a BASIC program from diskette and immedately execute the program at 

the lowest program Pne. 

If the ",R K option is specified, the fies wil remain open. 



SAVE Save BASIC program onto dbkette, 

SAVEvar$[,A] or SAVE , flespec , [^} 

This command alows you to transfer the^current BASIC program onto the tfiskette in compressed format. 
The "A" option wfll cause the program to be stored in ASCII format. Compressed programs load faster 
than ASCII programs but cannot be intellgently fsted from MULTIDOS. 
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SUPERBASIC - FBe Access. 

OPEN Sets the mode and assigns fiebuffer to a flespec 

(1} OPENmode£uf,var$ 

mode b a string or constant, and b one of the folowing: 
mode access mode 

D RANDOM I/O to an existing file. 

E SEQUENTIAL OUTPUT to an existing file. 

I SEQUENTIAL INPUT from an existing file. 

O SEQUENTIAL OUTPUT to a file. 

R RANDOM I/O to a file. 

buf = equivalent to the fie buffer which wil be assigned to var$". buf value MUST be 1 to "ff", 

whereas "ff" b the number of fie buffers opened during SUPERBASIC Initial^ation. 
var$ = a string defined as a flespec. 

(2) OPENmode J buf,var$,udl 

mode fe "R", and udl = user defined record length. 

(if mode - "D", udl b ignored, but no error b generated.) 

EXAMPLES: let N = 2, Q$ = "IOTA", P* = "CHECKING /TXT". 

OPENQ$,N,P$ 

Opens the fie •CHECKING/BAS" for sequential Input into fte buffer 2 (The fie MUST erfst). 

OPEN^O'A'BALANCE/TXT" 

Opens the fie "BALANCE/TXT 1 , sets the pointer to the beginning of the fie, and assigns fie buffer 
3 to the fie. 

When the "O" mode b used, if the flespec does not exist^ It wil be created with the pointer (naturally) 
set to the beginning of the fie. Nevertheless, if the fie existed or not; the "O" mode will set the pointer 
to the beginning of the fie; whereas the B E" mode wit set the pointer to the end of fie, "EOF 1 . If the 
fie does not exist in OPEN"E", the "EOF 1 w*1 be the beginning of the fie! 

Only one fie buffer may be assigned to the "D" f "E", "O", and "R" modes, whereas the "1" mode may 
have two or more, tn addtion, a fie buffer may not be assigned to more than one flespec at a time. 
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CLOSE Unasslgn a fie buffer by buffer number.. 

aOSE[#][buft,buf-3] 

buf = an expression with a value of 1 to 15. If buf Is omlted, al open fie buffers wBI be 
closed. 

EXAMPLE: 

CLOSE f 3 Closes file buffer 3. 

CLOSE 8,2,4 Closes file buffers 2, 4, and 8. 

CLOSE T Close file buffer equivalent to 

the value of "T". 
Anything which generates a CLEAR statement dlrectfy or as a subroutine wil close al ties. The folowing 
wll close al fles: NEW, LOAD/RUN (without ".R"), MERGE, EDITlng a program line, and CLEAR. 

INPUTf OPEN")" read command. 

INPUT#xitvar[,var-] 

buf = fie buffer 1 to 15. 

var = a variable name to contain the data from the fie. 



UNEINPUTJ OPENM" read a string to ODH (13 dec). 

UNEINPUT#buf,var$ 

buf = fie buffer 1 to 15. 
var$ = the variable name to contain the string. 

UNEJNPUT* will read al characters from the current position up to and inckiding a ODH (not preceded 
with an OAH), up to the end of file, or 255 characters - whichever comes first. 



PRINTS OPEN"0" and OPEN"E" write command. 
PRINT#buflUSINGformat$;]item[m jtem^l 

buf = a file buffer 1 to 15. 
format = a sequence of field specifiers used with USING, 
m = a delimiter placed between "items". 
item = an expression to be evaluated and written to the diskette, 
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The "Item- delmlter, "m", cm be a semi-colon ■;« or comma «/. The use of these deSmlters wilt 
determine the format on the diskette. If the con 
the diskette. This consumes diskette space rapidly. 



The "item" delmlter, B m\ can be a seml-colon -;■ or comma -,-. '" e use Ul u,w u ™ "■■ "' 

determine the format on the_ dbkette. If the comma b used, the "items" wBl be zoned in 16 byte areas on ,■ 



FIELD OPEN'D" and OPEN'R" file buffer organizer. 

FIRD[#]buf,1en1 AS strUt,len2 AS str2$-] 

buf = a file buffer 1 to 15. 
lenl = the length of the first field. 
str$1 = the variable name of the first field. 

Ien2 = the length of the second field. 
str$2 = the variable name of the second field. 

... » subsequent ten AS str$ pairs for the balance of the buffer 
size. The size Is determined by the user for created files 
or by the fife itself for existing files. 

All of the data items for RANDOM I/O are defined as strings. To convert numeric data to a string, the 
folowing factions are used: 

MCI$(num) num Is an INTEGER number. 
NKS$(num) num is a SINGLE PRECISION number. 
MKD$( num) num I s a DOUBLE PRECISION number. 

The length of the string b determined by the precbion of the convert function. MKIJ creates a 2 byte 
string, MKS$ creates a 4 byte string, and MKD$ creates an 8 byte string. 

In order to convert the string back to a number, the folowing fimctions are used: 

CVl(str$) str$ Is a 2 or greater-byte string. 

CVS{str$) strj Is a 4 or greater byte string. 

CVD(str$) str$ is a 8 or greater byte string. 



Procedure to write to a RANDOM file. 

Once a RANDOM buffer has been FIELDed, and at necessary numbers are converted to a string the data 
must be placed into the fie buffer. The commands LSET and RSET are used to place the «str$- used in 
the FIELD statement into the assigned fie buffer. 

LSETstrJ = expj 
RSETstr$ = exp$ 

str$ = a FIELDed variable name, 
exp* = the assignment for $tr$. 

The command LSET wll left Justify the »exp*« into the RAM space ported to by «str$". The RSET 
command wBl rfeht justify "exp*" into the RAM space pointed to by Htr$». 
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NOTE: If "str$" has not been assigned to a RANDOM file buffer, then LSET or RSET wfll ST1L reassign 
"exp$" to this string. I Just gave you a Httle rope herein 

LSET and RSET will not increase the length of «str$«. If ■«*$■ is longer than ■str$», the characters to 
the RIGHT are truncated. 



PUT OPEN n D" and OPEN"R" write statement. 

PUT[#]buff,rec] 

buf = a fie buffer 1 to 15. 

rec = the record number. If rec is omitted, the current record b used. The current record ts 
one unit greater than the last record written. 

The PUT statement will write to a fie if the record length is 256 bytes. 

if record length other than 256 is used, {only possible using the V option at BASIC initiation), then 
MULTIDOS will wait unti the I/O buffer is ful before a write b executed; 

Le OPEN"R",l,"POKER/TXT",67. 

To recap a RANDOM write to a fie, the foiowfng steps are necessary: 

(1) OPEN the fie — use 'R" or "D 1 (if it isn't already). 

(2) FiB_D the fie buffer. 

(3) Use MKIt, MKS$, MKD$ as necessary. 

{4) L5ET or RSET ad data to the fie buffer. 
(5) PUT the record. 

Procedure to read from a RANDOM fie. 

In order to read from a RANDOM fie, the fie must be OPENed first, then FlELDed per your 
requirements. The GET command will read a record Into the fie buffer. The "strj" tn the FIELD 
statement will now have the equivalent of the contents in record read. 



GET OPENED" and OPEN , R" record getter. 

GET[#]bufl/ec] 

buf = fie buffer 1 to 15. 

rec = the record number. If rec b omitted, the current record b used. The current record ts 
one unit greater than the last record read. 
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To recap a read from a RANDOM fie, the foBowing steps are necessary: 

(1) OPEN the Se (if it isn't already). 

(2) FIELD the buffer. 

(3) GET the record 

(4) CVI, CVS, CVD as necessary. 

NOTE: Using a str$ in an assignment, on the left side of an equals sign, de-alocates the field assignment to 
the particular str$. 

Fie position Indicators. 

SUPERBASIC has three fie position indicators which can be used with OPEN'D 1 , OPEN"!", and OPEN'R". 

EOF End of fie detector. 

EOF(buf) 
This function returns a zero If the end of fie has not been read. Otherwise a -A is returned. 

LOC Fie location Indicator. 

LOC(buf) 

This function returns one unit higher than the current record read for OPEN-D" and OPEN«RV For 
OPEN"!", IOC returns one unit higher than the last sector read (physical records). 

LOF Last record irxScator. 

LOF(buf) 

This function returns the highest logical record for OPEN-D- and OPEN-R-. For OPEN"!-, LOF returns the 
highest physical record (sector). 
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MU.T1rl£/MULTl-AUTO - a usefJ application, , : ;.^,-; 

;A'"m^ti^e AUTO comm^ «y era ! commands separated with a Inefeed, 

<J>, (down'' arrow). ■■,■■_ -xS\-?> r - " ,'- ^"■'t^l ' '"■''' 4 ; ^ : - '/ .. " ; ■' * '■■■■■ ■.■■ ■-'-"' 
A^miititAUTO 'command Es an AUTO command which b a miitlp^e DOS command. Le. DIRLIB,FREE. 

MdtijJe; AUTO commands:^ Is executed, whereas a miiti-AUTO 

command Twill display the multiple DOS command orily pnce. 

In a mJtiple/muiti-AUTb command, if 'you want to go into SUPERBASfC, BASIC must be the last 
command^/ ? ; .' ;'.- : ■'.'■■' v^r--"' 

In a muiti-AUTO command a "DO" fie wil write over the DOS command buffer; therefore, can only be 
the last command in a multiple DOS command Sne. 

In order to excute a "DO" tte, then a COMMAND, then back to a "DO" fie during power-up, use the 
multiple AUTO command, 

EXAMPLE: 

AUTO DO SPL<LF> 

VFU<LF> 

DO GEN<ENTER> 

Upon power-up/re-boot fie SPL/IDO wil be executed with al key inputs from the fie SPL/IDO. Then 
VFU/CMD will toad and execute, getting key inputs from the user. After VFU/CMD has terminated, the fie 
GEN/IDO wil provide al key inputs until it reaches its EOF. 

Another space saving feature of the multiple/multi-AUTO function, h its ablity to execute several 
commands, which w*l save that minimum one granule "DO" fie. 

Let's say you want to load a serial driver (SERDVR/CMD) then run a BASIC program. You can use the 
multiple/multi-AUTO command to handle tms 'command onh/ task without consuming an entire granule of 
cfsk space. 

AUTO SERDVR/CMD<F> 

BASIC RUN«MYPROG/BAS"<ENTER> 

Remember, the AUTO command can oniy contain 31 characters, which include spaces, commas, and fnefeed 
characters. The above example has 32 characters. The last quote mark wll be overwritten with the 
<ENTER> character. Thfc wil not produce an error in this example but would produce an error if the 
serial driver program's name was one byte longer. 

Suggestion: Use short fienames. 

PAGE 4400 MULT1DOS MODEL III (version US) 9/28/1962 

These addresses wll be useful for assembly language programmers. Al addresses wil be described; however, 
not U wil be useful for your particular application. Addresses particular to the MODEL 1 are noted. Same 
for the MODEL HL 
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LABEL ADDRESS LEN 
DOS 4400 3 
DATA 4403 
EXEC 4405 

REPDOS 4408 
ERROR 4409 
DEBUG 44 0D 



I US 4410 
{MODEL I ) 



2 

3 
1 
4 
4 
3 



TOPMEM 44 It 2 
(MDDEL III) 

SUB Y 4413 6M 
(MODEL Ml) 

DUS 4413 3 
(MODEL I ) 

SUB Z 4414 5 
(MODEL 111) 

IDS 4416 3 
(MODEL I) 

ICAT 4419 3 
(MDDEL III) 

DDS 4419 3 
(MODEL I) 

FILK 441C 3 

VERB 441 F 1 

INIT 4420 3 

GBYT 4423 1 
(MODEL III) 

4423 1 
(MODEL I) 

OPEN 4424 3 



ACCESSED USED FUNCTION 
A BC DE HL 

JUMP XXX X LOADS DOS1 , DOS INTERPRETER 

LOAD/READ LOADED BY DOSO FOR DCB 

JUMP X X X X EXECUTE OOMMAND @(HL) 



LOAD /READ 

CALL (JUMP) X 

CALL 

CALL X 

READ /LOAD 

CALL X 

CALL X 

CALL X 

CALL X 

CALL X 

CALL X 

CALL S 

READ 

CALL E 

READ 

READ 

CALL E 



LOADED/READ FOR REPEAT 

INTERROGATE ERROR IN A 

LOAD/EXECUTE DEBUG 

X INSERT USER INTERRUPT 

SERVICE, e DE POINTER, INTO 
SLOT A 

TOPMEM ADDRESS 
X LOADS HL WITH (HL)+1 



X X DELETE USER INTERRUPT FROM 
SLOT A 



X LOADS H. WITH (HL) 



X INSERT DEFAULT SERVICE 
@ DE, (NO POINTER!) 

INTERNAL CATALOGER 



X X DELETE DEFAULT SERVICE 

X POSITIONS FILE @(HL) TO (DE) 
2ND BYTE OF WRITE VECTOR 
INIT FILE, DE=DCB 
GRAPHICS IF NON ZERO 

NULLS AFTER LINE FEED 

OPEN FILE, DE=DCB 
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LABEL ADDRESS LEN 
LAST 4427 1 
CLOSE 4428 
DOING 442B 
KILL 44 2C 



ACCESSED USED FUNCTION 

A BC DE HL 
READ/LOAD CONFIG OF LAST READ DRV 



3 
1 
3 
t 



442F 
(MOOEL 111) 

442F 
(MODEL I) 



LOAD 4430 3 

LRUN 4433 3 

READ 4436 3 

WRITE 4439 3 

VERF 44 3C 3 

REWIND 443F 3 

POSN 4442 3 

BCKSPC 4445 3 

POSEOF 4448 3 

DEXT 444B 2 

FUNC 444D 2 

FORCE 44 4F 2 

DEVID 4451 3 



CALL E 
READ /LOAD 
CALL E 



READ 

CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
READ 
READ 
CALL 



PARAM 4454 


2 


CALL 


FIXDEN 4456 


14M 


CALL 


(MODEL 1) 






FIXDT 4459 


11 


CALL 


(MODEL I) 







CLOSE FILE, DE=ODCB 
NON ZERO IF "DO" ACTIVE 
KILL FILE, DE=ODCB 
UNASSIGNED 

CLOCK BYTE 

E B X LOAD FILE, DE=DCB 

E B LOAD/RUN FILE, DE=DCB 

E READ FILE, DE=CDCB 

E WRITE FILE, DE=ODCB 

E WRITE FILE/REREAD DE=ODCB 

E POSITION AT BEGlhWiNG 

E POSITION © BC LOGICAL RECORD 

E BACKSPACE ONE LOGICAL RECORD 

E -POSITION TO END OF FILE 

JUMP RELATIVE TO DEXT1 

OVERLAY CALL ADDRESS 

DISK I /O TEST ADDRESS 

X X DIVIDE HL BY A, HL = 
QUOTIENT, 
A = REMAIM5ER 

JUMP RELATIVE TO PARAM1 

X SET CONFIG TO 'A' DRIVE 

X SET CONFIG TO 'A' 
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LABEL ADDRESS LEN ACCESSED 

JKL 4461 3 CALL 
(MODEL I) (Available at 01D9H 

CEOF 4464 3 CALL 

VOD 4467 3 CALL 

PRLIN 446A 3 CALL 



DTP 44 6D 3 CALL 
(MODEL III) 

TIME 446D 3 CALL 
(MODEL 1) 

STS 4470 3 CALL 
(MODEL IN) 

DATE 4470 3 CALL 
(MODEL I) 

DEXT1 4473 3 CALL 



PARAM1 4476 3 CALL 

DOSCAL 4479 3 CALL 

ADRQ 44 7C 5 CALL 

SUQQ 4481 5 CALL 

STQ 4486 13 CALL 

LWMT 4493 9M CALL 

WAIT 4495 7 CALL 
(MODEL III) 

WAIT 4496 7 CALL 
(MODEL 1) 

FRM1 44 9C 3 CALL 

WAT 44 9F 2 READ 
(MODEL II!) 



USED FUNCTION 
ABCDE HL 

X XX DUMP SCREEN <80H 
MODEL III). 



X C 



X RETURNS EOF STATUS 



X XX SENDS TO (401E) @ (HL) 

UNTIL 03 OR OD 

X XX SENDS TO (4026) ® (HL) 

UNTIL 03 OR OD 

X RETURNS CONFIG PRESENT 



X X X X TIME 



X RETURNS CONFIG OF "A 1 DRIVE 

X X X X DATE 

XX X ADDS EXTENSION @ (HL) TO 
(DE) IF NONE 

X X X X (DE) « TABLE, (HL) @ PARA 
X X X X EXECUTES COMMAND © (HL) 



X 
X 
X X 



FORCES PRESENT CC^FIG TO 'A' 

SET CONFIG TO (IX+6) 

C RETURNS 5 IF S-DEN/P-DEN, 
OR 6 IF D^DEN 

OUTS (0F0H),A 

WAIT 179 <T' STATES 

WAIT 179 , T' STATES 



XX X SPOOL LINK TO FORMS 

ADDRESS OF FORMS/SPOOL 
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( 



LABEL ADDRESS LEN ACCESSED 
FPOS 44A1 10 CALL 
SEEK 44AB 30 CALL 
MOTON 44C9 3 CALL 



GRDUM 44CC 


3 


CALL 


WAT 44C7 


2 


READ 


[MODEL 1) 






ZZZZ 44CF 


3 


CALL 



IUS 
{MODEL 


44D2 
III) 


3 


DTF 
(MODEL 


44D2 
1) 


3 


DUS 
(MODEL 


44D5 
111) 


3 


STS 
{MODEL 


44D5 
1) 


3 


IDS 
(MODEL 


44D8 
Ml) 


3 


DDS 
(MODEL 


44DB 
III) 


3 



READV 44DE 



READS 44E1 



CALL 



CALL 



CALL 



CALL 



CALL 



CALL 



CALL 



CALL 



WRITS 44E4 4 CALL 



DIRRD 44E8 3 CALL 



D1RWT 44EB 3 CALL 



USED FUNCTION 
A BC DE HL 

X X HL=EOF A=REL BYTE IN SECTOR 

X FDC STEPS PORT F3 TO PORT F1 

X SELECTS DRIVE 'C 

X XX TRANSFERS DISPLAY TO (4026) 

ADDRESS OF FORMS/SPOOL 



X X DISPLAYS PRESS "ENTER 8 

WHEN SYSTEM... AND WAITS 
<ENTER> 

X INSERT USER INTERRUPT 

SERVICE, © DE POINTER, INTO 
SLOT A 

RETURNS CONFIG PRESENT 



X X DELETE USER INTERRUPT FROM 
SLOT A 

RETURNS CONFIG OF 'A' DRIVE 



X INSERT DEFAULT SERVICE 
6 DE (NO POINTERI) 

X X DELETE DEFAULT SERVICE 



READ SECTOR FOR PARITY 
C=DRV E=SEC D=TR 

READ SECTOR INTO {H. ) 
C=DRV E=SEC D=TR HL=BUFF 

WRITE SECTOR FROM (HL) 
C=ORV E=SEC D=TR HL^BUFF 

READ DATA(DIRECTORY)SECTOR 
C=DRV E=SEC D=TR HL=BUFF 

WRITE DATA SECTOR 

C=DRV E=SEC D=TR HL=BUFF 



Page 89 



LABEL ADDRESS LEN ACCESSED 
RDIRP 44EE 3 CALL 

WDIRP 44F1 3 CALL 

USRF 44F4 3 CALL 



GETDT 44F7 



MODE 44FA 



OPES A 44 FD 



CALL 



CALL 



CALL 



USED 

ABCDE HL 
E 

E 

E 



TECHNICAL 

FUNCTION; 

X EXITS WITH HL=43X0 

X EXITS WITH HL=4300 

SENDS TO FDC 'A' FUNCTION 
(DO NOT USE TO READ TRACK} 

LOAD D WITH DIRECTORY 
TRACK OF DRIVE C 

? CHECKS FOR UNWRITTEN CONTENTS 
FOR ONE BYTE WRITES. 
IF UNWRITTEN WRITES IT. 

SAVE REGISTERS WHEN (DE) # 
OPEN DCB, EXITS WITH 1X=DE. 



This b the total access to the "NUCLEUS" (DOS/SYS) used by al of MULT1DOS overlays and ulities. None 
of these programs make a CAli, LOAD, JUMP, OR READ above 44FDH. However, there b a major 
scratchpad area in the 4200H page MOD ill, and 4300H page MOD I. 

NOTES: 

4400H is a dead end jump, 

440SH is a dead end jump. 

4409H is dead end unless bit 7 is set in A. 

None of these routines use the IX, IY, alternate accumulator nor alternate registers BC, DE, & H- 

Obviously, al registers (not alternates) are used by executing most Library commands. 

X Where an "X" appears, the register pair is altered. 

Where a single register appears, only that register is altered, 

S Under FIX, A returns a zero rf vafid fflespec, otherwise non-zero. 

E Where "E' appears the accumulator has an error code if non-zero. 

CAVEAT 

VERB, GBYT, and DOING w3l create a disaster if altered by user. DO NOT ALTER! 

In fact don't poke anything into MULTIDOS. We have noticed that several application programs poke DEBUG 
off when loaded, especially those made for the SHACK. This wQI probably cause MULTIDOS to reboot. If 
you run into this problem, let us know, and we wSI tell you where to zero out this superfluous code. 
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DRIVE TABLE 

The numbers represent drive zero to drive three respectfully. 

428CH to 4283H - MOD III, 4300H to 4303H - MOD 1 Current head position for drives other than 
present. 

4284H to 4287H - MOD tl!, 4304H to 4307H - MOD I Current track for directory. 

42SSH to 428BH - MOD III, 4303H to 43QBH - MOD I Current CONFIG for drives. 



CONFIG bit pattern: 






BIT 


IF SET 


IF NOT SET 


REMARKS 


7 
6 


DOUBLE DENSITY 
DIVISION 2 


SINGLE DENSITY 
NO DIVISION 2 


TS=DE/1.8 


5 
4 


TWO SIDE 


SINGLE SIDE 


NOT ASSIGNED 


3 
2 
1 
r> 


DIVISION 1 

DOUBLE STEP © SEEK 


NO DIVISION 1 


TS=DE/!.8+l 
READ 40 IN 80 
SPEED 
SPEED 



NOTE: If bit 6 is set, bit 3 must be set to divide. 

In reading a directory, MULTIDOS wll automatically flip bits 7, 6^ and 3 as required. However, in raw 
reading a sector (such as ZAP programs do) only bit 7 wBl be changed as necessary. 

EXAMPLES 

1. Lefs change drive 2 from single density to DBLDOS {tm): 

LD A, 2 

CALL 5TS 

OR 88H 

CALL FiXDT 

2. To determine what was just read successfully: 

The CONFIG is in ram location 4427 f-A5T) 

LD A, (LAST) 

BIT 6, A 

JR NZ.NEWDOS 80 

BIT 3, A 

JR NZ, DBLDOS 

BIT 7, A 

JR NZ, DOUBLE DENSITY 

(SINGLE!) 
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SYSTEM ROUTINES and pertinent addresses 

These routines are usefti for machine language programmers. AI 4 character addresses are hexadecimal, 
and are the same for both versions of double density as wel as single density. 

The registers other then the AF, which are altered are Indicated next to the routine's description, 
preceeded by a colon ■;■• 

For fie manipulation routines, the DE register pair contains the address of a 20H byte DCB (device control 
block). This will be indicated by DE=DCB next to the routines 1 descriptions. 

The following are bytes, words, calls, Jumps, or a group of bytes used by MULTIDOS. The addresses wll be 
suffixed with "b", H w", "c", "j", and "g" respectively. 

■ i* 
0013 c One byte read DE=DCB 

This routine wQI return the byte read into the A register if the Z flag is set otherwise the A register 
contains the error code. When the EOF is reached, this routine wit return a 1CH without the Z flag set. 
This is the expected exit from this routine when al data has been read. 

001 B c One byte write DE=DCB 

This is a very useful routine for writing to a fie using al current DOS 1 *. In each case, each DOS will 
maintain the proper NEXT and EOF vaktes. Since the user should know when the last byte has been 
written, the proper EOF state w9! be properh/ set by each DOS. 

The A register contains the byte to be written. If the Z flag b set after this routine was called the write 
was successful, otherwise the A register contains the error code. 

4O0F c ENTER Debugging Package 

RST 30H vector. This is set to JP 440D at power-up/re-boot. A JP 440D wil load and execute DOS5/SY5, 
DEBUG. Users who have other monitors, may insert their monitors entry point in (4010) to execute their 
monitor in lieu of DOS5/SYS. Ths is unique to MULTIDOS. 

402D j DOS EXIT :AB 

This routine wfll terminate any caBs and load the SP with the DOS stack location. Al of MULTIDOS Ibrary 
commands & utilities exit to this address, error or no error. During a CMD a uuuuu" from SUPERB ASIC, the 
location pointed to by this address is temporally altered to return to SUPERBASIC, and all registers are 

maintained. 

4030 j DOS EXIT :AB 

This k MULTIDOSH no bang exit. This is unique to MULTIDOS. 

4040 - 4046 g (4216 - 421C MOD 111) 

The bytes are ticker, seconds, minutes, hours, year, day, and month respectively. 



Page 92 



TECHNICAL 

4049 w (4411 MOD III) TOPMEM address 

This address contains the highest byte of memory MULTIDOS, MULTIDOS utilities and SUPERBAS1C wPi use. 
Protected memory is one byte higher than this address. During SUPERBASICs CMD^uuuuu" this address b 
temporarly altered to protect SUPER8ASIC and any BASIC program in memory. 

4400 j DOS EXIT 

This is the address pointed to by 402D unless a CMD"uuuuu" is in process. 

4405 j Execute COMMAND :BC, DE, U. 

Thh routine wfl! execute the COMMAND at the address contained in the H. register pair (text pointed to 
by H.). The length of this COMMAND Is unimited and should be terminated with a byte which has the 
value of 00 to OD. Upon completion of the COMMAND a 402D exit wBl be envoked. 

4409 c Display DOS ERROR 

This routine will dhpiay the error message which corresponds with the byte in the A register bits thru 
5. If bit 6 is not set, a hex to decimal conversion of the error message is displayed via, 
•DOS ERROR = XX". 

If bit 7 is not set a jump to 4C2D is invoked; otherwise, a return, with aS registers maintained, occurs. 

440D c Enter DEBUG 

This routine wDI return to the instruction folowing a 440D call if the SP is not altered, other than calls 
encountered whle debugging a user routine. 

4410 c (44D2 MOD IN) Insert a foreground task. :H- 

This routine wit insert a routine to be executed, whenever the interrupt service is activated. MU-TIDOS has 
12 avalable dots,on the MOD I, and 10 on the MOD III. Slots to 7 (0 to 5 MOD III) are executed 
every 200 mS, and slots 8 to 11 (6 to 9 MOD HI} are executed every 25 mS (33 1tf mS MOD 111). On 
entry, the A register contains the slot number, and DE contains an address which POINTS to the routine. 
When' a user interrupt routine is entered, the interrupts have been disabled and MUST remain dbabled. Do 
NOT use the video routine, 33^ on the MOD III - It enables the interrupts - briliantIL Al registers 
except the IV register pair (IY is saved on the MOD III) are saved and the H. register contains the 
address of the start of this routine. 



Page 93 



TECHNICAL 



EXAMPLE: 

5 20 OH 
5202H 

520SH 
5208H 



ORG 5200H 
Lt> A,4 

LD DE, POINT ■ ': 
CALL 4410H 
(return to user program) 



OFFEBH 
OFFEDH 
OFFEEH 
0FFF1H 
0FFF2H 
0FFF4H 
0FFF7H 
0FFF8H 
OFFFAH 
OFFFDH 
OFFFEH 



WORK 



POINT 





ORG 01 


LD 


A,0 


CPL 




LD 


(YiORK+1 ) ,A 


OR 


A 


LD 


A.2AH 


LD 


(3C3CH),A 


RET 


Z 


LD 


A,20H 


LD 


(3C3CH),A 


RET 




DEFW 


WORK 



OFFEBH 



Every 200ms the routine at FFEB is executed. 
(This routine flashes an asterisk 25 times a second) 



4413 c (44D5 MOD HI) Delete a foreground task. :H,DE 

Thb routine wBI delete a user task from the interrupt chain. The A register contains the dot number for 

the deletion, 

4416 c {44D8 MOD II!) insert default foreground task. :HL 

This is a default insert routine. The interrupt chain works on the principle of address pointers. If an 
insertion is made via a 4410 (44D2 MOD lit) caB, an address is inserted which contains an address that 
points to a user routine. Where there are no user insertions, the remaining slots contain an address which 
has an address that points to a RET instruction. A cal to 4416 {44D8 MOD HI) wil change the address 
which points to a return instruction to the address in the DE register. The user routine does NOT need to 
have a pointer. 

4419 c (44DB MOD HI) Delete default foreground task. :DE,HL 

Thfe routine w3l set the default pointer to a RET instruction. 

441C c Extract a fiespec :AF, BC, HL 

This routine w3l transfer the text pointed to by HL to the location pointed to by DE, and terminates it 
with a 03H. 

This routine converts the text pointed to by H_ into the fiespec syntax to the location pointed to by DE. 
Ail lower case letters are converted to uppercase. 
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TECHNICAL 

EXAMPLE: 

ri=>abcdefghj/PQ1.K478ABQWNO:3<CR> 
CALL 441 C 
DE=>ABCDEFGH/PQ1.K478AABQW:303> 

4420 c OPEN/INITIALtZE. DE=DCB (name) 

On entry the FL points to a 256 byte buffer, then a call to 4424 is made. If the 4424 call returns zero 
{file already exists) this routine wil exit. Otherwise, the fie is created with the logical record length in B. 
After the file is created the fie Is opened. If no error occurs the carry flag is set. 

4424 c OPEN. DE=DCB (name) 

On entry the HL points to a 256 byte buffer. The iogcal record length is extracted from the directory 
entry of the fSespec This fc a major difference in MULTIDOS 

4428 c CLOSE D£=DCB (open) 

442C c KILL DE=DCB (open) 

4430 c LOAD DE=DCB (name) 

4433 c LOAD then EXECUTE DE=OCB (name) 

4436 C READ DE^DCB (open) 

4439 c WRITE D£=DCB (open) 

443C c VERIFY DE=DCB (open) 

443F c POSITION at start of file DE=DCB (open) 

4442 c POSITION at BC logical record DE=DCB (open) 

4445 c BACKSPACE one logical record DE=DCB (open) 

4448 c POSITION at the end of file DE=DCB (open) 

4467 c VIDLIN :DE,HL 

This routine will send to the DCB at 401D, the string at the address contained in the H. until a 
terminator, 03H or ODFL is encountered. If the terminator is an ODHj, then It is sent also. Note MULTIDOS 
does NOT maintain the FL register. 

446A c PRTUN :DE,H. 

Thfc routine is the same as 4467, except the DCB is 4025. 

446D c GETTIM (3036 MOD III) :BCpE^t 

Th's routiic tranforms RAM time to rH:MM:SS format tn the address contained in the HL. 

4470 c GETDAT (3033 MOD 111) :B€,DE,H- 

This routine tranforms RAM date to MM/DD/YY format in the address contained in the FL. 
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4473 c (4448 or 4473 MOD III] Add default extension :BC,DE,HL 

4476 c (4454 or 4476 MOD HI) Get parameter values, :BC J Dt;HL- 

This routine willconvert both decimal and hex numbers. Hex numbers use the "X" convention. This 
is accomplished with the letter «X* folowed by a hexadecimal number enclosed in single quotes. 
Thus the number 100 could be written as.X*>4'. 

The following are MULTIDOS raw disk I/O caBs. 

When "CONDI" appears, ft represents the following condition: 

register C = drive number (Modulo 4) 

register D = track number 

regi st er E = sector 

tn the register used column, when you see A=error, If there is an error the Z flag will be reset and 
the accumulator, A, wHI contain the error code; However, if you perform a read, or read verify on a 
directory sector without a DIRECTORY type command, the A register should contain an error code of 
6. 



CALL 

44DE 
44E1 
44E4 

44E8 

44EB 
44EE 

44F1 

44F4 
44F7 



FUNCTION 

READ VERIFY 

READ SECTOR 

WRITE SECTOR 

READ DIRECTORY 
SECTOR 

WRITE DIRECTORY 
SECTOR 

READ DIRECTORY 
Pos i t ion 



WRITE DIRECTORY 
Pos 1 t Ion 



REGISTERS REQUIRED REGISTERS USED 

CONDI A=error 

CONDI, and IL=buffer A=error 

CCre>l , and H.=buffer A=error 

CONDI, and HL=buffer A=error 

CONDI, and H_=buffer A=error 



USR FUNCT 



GET DEFAULT 
DIRECTORY TRACK 



C=dr i ve, 

bi ts 5-7 8=position 

bits 0-3 B=dir sec+2 

C=dr ive, 

bits 5-7 B=pos i tion 

bits 0-3 B=dir sec+2 

COND1 , A=FDC code 
HL=buffer if req'd 

C=drive 



HL=42XX (43XX Mod |Ii),A=error 



HL=4200 (4300 Mod lll),A=error 



A=error 



D=track 

E=unchanged 



The balance of DOS/SYS, 4500H to 4CFFH contains the code to execute these functions, as wel as 
other routines, tables, pointers, and several I/O devices- 
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MULTIDOS SYSTEM FLES 

( DOS/SYS - 3 grans - 4300H to 4CFFH. 

Resident fBe loaded during power-up/re-boot. 

DOSO/SYS - 1 gran - 4EO0H to 5QFFH. 

CMD"uuuiiu» executor, granule allocation, and extended directory entries. This fie must be on a system 

diskette, 

DOS1/SYS - 1 gran - 4D00H to 51FFH. —-,,* > m 

DOS COMMAND interpreter, library commands: BLINK, BOOT, BREAK, CLEAR, CLOCK, CLS, DEAD, LIB, 
LOAD, and VERIFY. This file must be on a SYSTEM diskette. 

DOS2/SYS - 1 gran - 4EO0H to 51FFH. 

INfT and OPEN. This fSe must be on a SYSTEM diskette 

DOS3/SYS - 1 gran - 4E00H to 50FFH. 

CLOSE and KUL. Thfe fie must be on a SYSTEM diskette. 

DOS4/SYS - 1 gran - 4D10H to 51FFH. 

DOS error messages. Contains code for FIND & CMD"U'. 

DOS5/SYS - 1 gran - 4DO0H to 51FFH. DEBUG 

DOS6/SYS - 4/5 grans (MODEL f), 4 grans (MODEL III) - 5200H to 67FFH. 
Library executor. 

DOS7/SY5 - 1 gran - 4DO0H to 51FFH. 

Mighty Multi, CMD^C, CMD"Q* and BASIC'S MAN functions. 

S"!,;!:^"^, ^^"U S S£J KM, PATCH P«OT. RENA ME. 
RESTOR, 5ETCOM, TIME, and TOPMEM. 

D059/SYS - 4/5 grans (MODEL I), 4 grans (MODEL HI) - 5200H to 67FFH. 
Library executor: HELP 

You may delete any of the /SYS files desired via VFU/CMD<s purge function. However, the Rowing must 
regain or, a sys^m dsk for proper fie man^ation: DOS0/5YS. DOS1/SYS, DOS2/SYS, DOS3/SYS and 
DOS4/5YS. 

You may deicte DOS4/SY5 if necessary. However, DOS errors wSl not be avalable. 

If you want to execute fSes on a diskette that do not CLOSE or KW. in their execution then DOS3/SYS 
may be deleted. 
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SUPERB ASIC overlays. 

EDIT/SVS - 1 gran - 4D00H to 51FFH. 
Performs BASIC global editing. 

RENUM/SYS - 1 gran - 4DO0H to 51FFH t 

Performs BASIC renumbering. 

CREF/SYS - 1 gran - 4DO0H to 51FFH. 
Performs BASIC cross reference. 

ERROR/SYS - 1 gran - 4D0GH to 51FFH. 
Displays BASIC error messages. 

These SUPERBASIC overlays may be deleted ff desired. 



SUPERB ASIC error messages and ERR codes. 
ERR ERR/2+1 Message 

100 51 Field organization exceeded 

the logical record length. 
Internal error, use CMD"E" for specific. 
The buffer number is not aval able 

or was used improperly. 
Directory does not contain fie. 
Incorrect fie mode. 
File previously opened. 
Disk read error, use CMD"E" for specific 
Disk write error, use CMD"E" for specific 
Fie already exists. 
End of fie encountered. 
Drive not aval able. 
Disk space full. 

"EOF" reached before any characters read. 
Bad "PUT" parameter. 
Improper fie name. 

Access mode differs from OPEN mode. 
Fie/Program delimiters are too far apart for buffer. 
Directory space futL 
The write protect notch is covered. 
Incorrect password used to access fie. 
Full directory. Fie cannot be extended. 
The fie has not been opened. 
Undefined function. 



102 


52 


104 


53 


106 


54 


108 


55 


110 


56 


112 


57 


1M 


58 


116 


59 


118 


60 


120 


61 


122 


62 


124 


63 


126 


64 


128 


65 


130 


66 


132 


67 


134 


68 


136 


69 


138 


70 


140 


71 


142 


72 


144 


73 
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MULTIDOS system error messages and error codes. 

00 No error. 

01 Parity error during header read. 

02 Seek error during read. 

03 Lost data during read. 

04 Parity error during read. 

05 Data record not found during read. 

06 Attempted to read system data record. 

07 Attempted to read NO ACCESS fSe. 

08 Drive not avalable. 

09 Parity error during header write. 

10 Seek error during write. 

11 Lost data during write. 

12 Parity error during write. 

13 Data record not found during write. 

14 Write fault on disk drive. 

15 Write protected diskette. 

16 Drive not avalable. 

17 Directory read error. 

18 Directory write error. 

19 Improper fie name. 

20 Granule alocation table read error. 

21 Granule alocation taable write error. 

22 Hash index table read error. 

23 Hash Index table write error. 

24 File not in drectory. 

25 File acces denied. 

26 Directory space full. 

27 Disk space full. 

28 End of fie encountered. 

29 No record found. 

30 Full drectory. Ffle can't be extended. 

31 Program not found. 

32 Improper drive number specified. 

33 Undefined error. 

34 Load fie format error. 

35 Memory fault. 

36 Attempted to load ROM memory. 

37 Access attempted to protected fie. 

38 Fie has not been opened. 

39 Side is not avalable. 

40 Undefined error. 
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